home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / share / mc / mc.hlp < prev    next >
Text File  |  2009-10-25  |  125KB  |  3,353 lines
  1. [Contents]
  2. Topics:
  3.  
  4.   DESCRIPTIONDESCRIPTION
  5.   OPTIONSOPTIONS
  6.   OverviewOverview
  7.   Mouse SupportMouse Support
  8.  
  9.   KeysKeys
  10.     Miscellaneous KeysMiscellaneous Keys
  11.     Directory PanelsDirectory Panels
  12.     Shell Command LineShell Command Line
  13.     General Movement KeysGeneral Movement Keys
  14.     Input Line KeysInput Line Keys
  15.  
  16.   Menu BarMenu Bar
  17.     Left and Right (Above and Below) MenusLeft and Right Menus
  18.       Listing Mode...Listing Mode...
  19.       Sort Order...Sort Order...
  20.       Filter...Filter...
  21.       RereadReread
  22.     File MenuFile Menu
  23.       Quick cdQuick cd
  24.     Command MenuCommand Menu
  25.       Directory TreeDirectory Tree
  26.       Find FileFind File
  27.       External panelizeExternal panelize
  28.       HotlistHotlist
  29.       Extension File EditExtension File Edit
  30.       Background JobsBackground jobs
  31.       Menu File EditMenu File Edit
  32.     Options MenuOptions Menu
  33.       ConfigurationConfiguration
  34.       LayoutLayout
  35.       ConfirmationConfirmation
  36.       Display bitsDisplay bits
  37.       Learn keysLearn keys
  38.       Virtual FSVirtual FS
  39.       Save SetupSave Setup
  40.  
  41.   Executing operating system commandsExecuting operating system commands
  42.     The cd internal commandThe cd internal command
  43.     Macro SubstitutionMacro Substitution
  44.     The subshell supportThe subshell support
  45.   ChmodChmod
  46.   ChownChown
  47.   Advanced ChownAdvanced Chown
  48.   File OperationsFile Operations
  49.   Mask Copy/RenameMask Copy/Rename
  50.   Internal File ViewerInternal File Viewer
  51.   Internal File EditorInternal File Editor
  52.   CompletionCompletion
  53.   Virtual File SystemVirtual File System
  54.     FTP File SystemFTP File System
  55.     Tar File SystemTar File System
  56.     FIle transfer over SHell filesystemFIle transfer over SHell filesystem
  57.     Network File SystemNetwork File System
  58.     Undelete File SystemUndelete File System
  59.     SMB File SystemSMB File System
  60.     EXTernal File SystemEXTernal File System
  61.   ColorsColors
  62.   Special SettingsSpecial Settings
  63.   Terminal databasesTerminal databases
  64.  
  65.   FILESFILES
  66.   AVAILABILITYAVAILABILITY
  67.   SEE ALSOSEE ALSO
  68.   AUTHORSAUTHORS
  69.   BUGSBUGS
  70.   LicenseLicense
  71.   Query boxesQueryBox
  72.   How to use helpHow to use help
  73. [DESCRIPTION]
  74. DESCRIPTION
  75.  
  76. GNU Midnight Commander is a directory browser/file manager
  77. for Unix-like operating systems.[OPTIONS]
  78. OPTIONS
  79.  
  80.  
  81. -a, --stickchars
  82.         Disable usage of graphic characters for line
  83.         drawing.
  84.  
  85. -b, --nocolor
  86.         Force black and white display.
  87.  
  88. -c, --color
  89.         Force color mode, please check the section ColorsColors
  90.         for more information.
  91.  
  92. -C arg, --colors=arg
  93.         Specify a different color set in the command
  94.         line. The format of arg is documented in the
  95.         ColorsColors section.
  96.  
  97. -d, --nomouse
  98.         Disable mouse support.
  99.  
  100. -e [file], --edit[=file]
  101.         Start the internal editor. If the file is
  102.         specified, open it on startup. See also mcedit
  103.         (1) .
  104.  
  105. -f, --datadir
  106.         Display the compiled-in search paths for Midnight
  107.         Commander files.
  108.  
  109. -k, --resetsoft
  110.         Reset softkeys to their default from the
  111.         termcap/terminfo database. Only useful on HP
  112.         terminals when the function keys don't work.
  113.  
  114. -l file, --ftplog=file
  115.         Save the ftpfs dialog with the server in file.
  116.  
  117. -P file, --printwd=file
  118.         Print the last working directory to the specified
  119.         file. This option is not meant to be used
  120.         directly. Instead, it's used from a special shell
  121.         script that automatically changes the current
  122.         directory of the shell to the last directory the
  123.         Midnight Commander was in. Source the file
  124.         /usr/share/mc/bin/mc.sh  (bash and zsh users) or
  125.         /usr/share/mc/bin/mc.csh  (tcsh users)
  126.         respectively to define mc  as an alias to the
  127.         appropriate shell script.
  128.  
  129. -s, --slow
  130.         Turn on the slow terminal mode, in this mode the
  131.         program will not draw expensive line drawing
  132.         characters and will toggle verbose mode off.
  133.  
  134. -t, --termcap
  135.         Used only if the code was compiled with Slang and
  136.         terminfo: it makes the Midnight Commander use the
  137.         value of the TERMCAP  variable for the terminal
  138.         information instead of the information on the
  139.         system wide terminal database
  140.  
  141. -u, --nosubshell
  142.         Disable use of the concurrent shell (only makes
  143.         sense if the Midnight Commander has been built
  144.         with concurrent shell support).
  145.  
  146. -U, --subshell
  147.         Enable use of the concurrent shell support (only
  148.         makes sense if the Midnight Commander was built
  149.         with the subshell support set as an optional
  150.         feature).
  151.  
  152. -v file, --view=file
  153.         Start the internal viewer to view the specified
  154.         file. See also mcview (1) .
  155.  
  156. -V, --version
  157.         Display the version of the program.
  158.  
  159. -x, --xterm
  160.         Force xterm mode. Used when running on
  161.         xterm-capable terminals (two screen modes, and
  162.         able to send mouse escape sequences).
  163.  
  164. If specified, the first path name is the directory to show
  165. in the selected panel; the second path name is the
  166. directory to be shown in the other panel.[Overview]
  167. Overview
  168.  
  169. The screen of the Midnight Commander is divided into four
  170. parts. Almost all of the screen space is taken up by two
  171. directory panels. By default, the second line from the
  172. bottom of the screen is the shell command line, and the
  173. bottom line shows the function key labels. The topmost
  174. line is the menu bar lineMenu Bar. The menu bar line may not be
  175. visible, but appears if you click the topmost line with
  176. the mouse or press the F9 key.
  177.  
  178. The Midnight Commander provides a view of two directories
  179. at the same time. One of the panels is the current panel
  180. (a selection bar is in the current panel). Almost all
  181. operations take place on the current panel. Some file
  182. operations like Rename and Copy by default use the
  183. directory of the unselected panel as a destination (don't
  184. worry, they always ask you for confirmation first). For
  185. more information, see the sections on the Directory PanelsDirectory
  186. Panels, the Left and Right MenusLeft and Right Menus and the File MenuFile Menu.
  187.  
  188. You can execute system commands from the Midnight
  189. Commander by simply typing them. Everything you type will
  190. appear on the shell command line, and when you press Enter
  191. the Midnight Commander will execute the command line you
  192. typed; read the Shell Command LineShell Command Line and Input Line KeysInput Line Keys
  193. sections to learn more about the command line.[Mouse Support]
  194. Mouse Support
  195.  
  196. The Midnight Commander comes with mouse support. It is
  197. activated whenever you are running on an xterm(1)  terminal
  198. (it even works if you take a telnet, ssh or rlogin
  199. connection to another machine from the xterm) or if you
  200. are running on a Linux console and have the gpm  mouse
  201. server running.
  202.  
  203. When you left click on a file in the directory panels,
  204. that file is selected; if you click with the right button,
  205. the file is marked (or unmarked, depending on the previous
  206. state).
  207.  
  208. Double-clicking on a file will try to execute the command
  209. if it is an executable program; and if the extension fileExtension File
  210. Edithas a program specified for the file's extension, the
  211. specified program is executed.
  212.  
  213. Also, it is possible to execute the commands assigned to
  214. the function key labels by clicking on them.
  215.  
  216. If a mouse button is clicked on the top frame line of the
  217. directory panel, it is scrolled one page up. Likewise, a
  218. click on the bottom frame line will cause scrolling one
  219. page down. This frame line method works also in the Help
  220. ViewerContents and the Directory TreeDirectory Tree.
  221.  
  222. The default auto repeat rate for the mouse buttons is 400
  223. milliseconds. This may be changed to other values by
  224. editing the ~/.mc/iniSave Setup file and changing the
  225. mouse_repeat_rate  parameter.
  226.  
  227. If you are running the Midnight Commander with the mouse
  228. support, you can get the default mouse behavior (cutting
  229. and pasting text) by holding down the Shift key.
  230.  
  231. [Keys]
  232. Keys
  233.  
  234. Some commands in the Midnight Commander involve the use of
  235. the Control  (sometimes labeled CTRL or CTL) and the Meta
  236. (sometimes labeled ALT or even Compose) keys. In this
  237. manual we will use the following abbreviations:
  238.  
  239. C-<chr>  means hold the Control key while typing the
  240.         character <chr>. Thus C-f would be: hold the
  241.         Control key and type f.
  242.  
  243. Alt-<chr>
  244.         means hold the Meta or Alt key down while typing
  245.         <chr>. If there is no Meta or Alt key, type ESC ,
  246.         release it, then type the character <chr>.
  247.  
  248. S-<chr>  means hold the Shift key down while typing <chr>.
  249.  
  250. All input lines in the Midnight Commander use an
  251. approximation to the GNU Emacs editor's key bindings.
  252.  
  253. There are many sections which tell about the keys. The
  254. following are the most important.
  255.  
  256. The File MenuFile Menu section documents the keyboard shortcuts
  257. for the commands appearing in the File menu. This section
  258. includes the function keys. Most of these commands perform
  259. some action, usually on the selected file or the tagged
  260. files.
  261.  
  262. The Directory PanelsDirectory Panels section documents the keys which
  263. select a file or tag files as a target for a later action
  264. (the action is usually one from the file menu).
  265.  
  266. The Shell Command LineShell Command Line section list the keys which are
  267. used for entering and editing command lines. Most of these
  268. copy file names and such from the directory panels to the
  269. command line (to avoid excessive typing) or access the
  270. command line history.
  271.  
  272. Input Line KeysInput Line Keys are used for editing input lines. This
  273. means both the command line and the input lines in the
  274. query dialogs.[Miscellaneous Keys]
  275. Miscellaneous Keys
  276.  
  277. Here are some keys which don't fall into any of the other
  278. categories:
  279.  
  280. Enter    if there is some text in the command line (the
  281.         one at the bottom of the panels), then that
  282.         command is executed. If there is no text in the
  283.         command line then if the selection bar is over a
  284.         directory the Midnight Commander does a chdir(2)
  285.         to the selected directory and reloads the
  286.         information on the panel; if the selection is an
  287.         executable file then it is executed. Finally, if
  288.         the extension of the selected file name matches
  289.         one of the extensions in the extensions fileExtension File Edit
  290.         then the corresponding command is executed.
  291.  
  292. C-l      repaint all the information in the Midnight
  293.         Commander.
  294.  
  295. C-x c    run the ChmodChmod command on a file or on the tagged
  296.         files.
  297.  
  298. C-x o    run the ChownChown command on the current file or on
  299.         the tagged files.
  300.  
  301. C-x l    run the link command.
  302.  
  303. C-x s    run the symbolic link command.
  304.  
  305. C-x i    set the other panel display mode to information.
  306.  
  307. C-x q    set the other panel display mode to quick view.
  308.  
  309. C-x !    execute the External panelizeExternal panelize command.
  310.  
  311. C-x h    run the add directory to hotlistHotlist command.
  312.  
  313. Alt-!    executes the Filtered view command, described in
  314.         the view commandInternal File Viewer.
  315.  
  316. Alt-?    executes the Find fileFind File command.
  317.  
  318. Alt-c    pops up the quick cdQuick cd dialog.
  319.  
  320. C-o      when the program is being run in the Linux or
  321.         FreeBSD console or under an xterm, it will show
  322.         you the output of the previous command. When ran
  323.         on the Linux console, the Midnight Commander uses
  324.         an external program (cons.saver) to handle saving
  325.         and restoring of information on the screen.
  326.  
  327. When the subshell support is compiled in, you can type C-o
  328. at any time and you will be taken back to the Midnight
  329. Commander main screen, to return to your application just
  330. type C-o. If you have an application suspended by using
  331. this trick, you won't be able to execute other programs
  332. from the Midnight Commander until you terminate the
  333. suspended application.[Directory Panels]
  334. Directory Panels
  335.  
  336. This section lists the keys which operate on the directory
  337. panels. If you want to know how to change the appearance
  338. of the panels take a look at the section on Left and Right
  339. MenusLeft and Right Menus.
  340.  
  341. Tab, C-i
  342.         change the current panel. The old other panel
  343.         becomes the new current panel and the old current
  344.         panel becomes the new other panel. The selection
  345.         bar moves from the old current panel to the new
  346.         current panel.
  347.  
  348. Insert, C-t
  349.         to tag files you may use the Insert key (the
  350.         kich1 terminfo sequence) or the C-t (Control-t)
  351.         sequence. To untag files, just retag a tagged
  352.         file.
  353.  
  354. Alt-g, Alt-r, Alt-j
  355.         used to select the top file in a panel, the
  356.         middle file and the bottom one, respectively.
  357.  
  358. C-s, Alt-s
  359.         start a filename search in the directory listing.
  360.         When the search is active, the user input will be
  361.         added to the search string instead of the command
  362.         line. If the Show mini-status  option is enabled
  363.         the search string is shown on the mini-status
  364.         line. When typing, the selection bar will move to
  365.         the next file starting with the typed letters.
  366.         The backspace  or DEL  keys can be used to correct
  367.         typing mistakes. If C-s is pressed again, the
  368.         next match is searched for.
  369.  
  370. Alt-t    toggle the current display listing to show the
  371.         next display listing mode. With this it is
  372.         possible to quickly switch to brief listing, long
  373.         listing, user defined listing mode, and back to
  374.         the default.
  375.  
  376. C-\ (control-backslash)
  377.         show the directory hotlistHotlist and change to the
  378.         selected directory.
  379.  
  380. + (plus)
  381.         this is used to select (tag) a group of files.
  382.         The Midnight Commander will prompt for a regular
  383.         expression describing the group. When Shell
  384.         Patterns  are enabled, the regular expression is
  385.         much like the regular expressions in the shell (*
  386.         standing for zero or more characters and ?
  387.         standing for one character). If Shell Patterns  is
  388.         off, then the tagging of files is done with
  389.         normal regular expressions (see ed (1)).
  390.  
  391. If the expression starts or ends with a slash (/), then it
  392. will select directories instead of files.
  393.  
  394. \ (backslash)
  395.         use the "\" key to unselect a group of files.
  396.         This is the opposite of the Plus key.
  397.  
  398. up-key, C-p
  399.         move the selection bar to the previous entry in
  400.         the panel.
  401.  
  402. down-key, C-n
  403.         move the selection bar to the next entry in the
  404.         panel.
  405.  
  406. home, a1, Alt-<
  407.         move the selection bar to the first entry in the
  408.         panel.
  409.  
  410. end, c1, Alt->
  411.         move the selection bar to the last entry in the
  412.         panel.
  413.  
  414. next-page, C-v
  415.         move the selection bar one page down.
  416.  
  417. prev-page, Alt-v
  418.         move the selection bar one page up.
  419.  
  420. Alt-o    If the currently selected file is a directory,
  421.         load that directory on the other panel and moves
  422.         the selection to the next file.
  423.  
  424. Alt-i    make the current directory of the current panel
  425.         also the current directory of the other panel.
  426.         Put the other panel to the listing mode if
  427.         needed. If the current panel is panelized, the
  428.         other panel doesn't become panelized.
  429.  
  430. C-PageUp, C-PageDown
  431.         only when supported by the terminal: change to
  432.         ".." and to the currently selected directory
  433.         respectively.
  434.  
  435. Alt-y    moves to the previous directory in the history,
  436.         equivalent to clicking the <  with the mouse.
  437.  
  438. Alt-u    moves to the next directory in the history,
  439.         equivalent to clicking the >  with the mouse.
  440.  
  441. Alt-Shift-h, Alt-H
  442.         displays the directory history, equivalent to
  443.         depressing the 'v' with the mouse.[Shell Command Line]
  444. Shell Command Line
  445.  
  446. This section lists keys which are useful to avoid
  447. excessive typing when entering shell commands.
  448.  
  449. Alt-Enter
  450.         copy the currently selected file name to the
  451.         command line.
  452.  
  453. C-Enter  same a Alt-Enter. May not work on remote systems
  454.         and some terminals.
  455.  
  456. C-Shift-Enter
  457.         copy the full path name of the currently selected
  458.         file to the command line. May not work on remote
  459.         systems and some terminals.
  460.  
  461. Alt-Tab  does the filename, command, variable, username
  462.         and hostname completionCompletion for you.
  463.  
  464. C-x t, C-x C-t
  465.         copy the tagged files (or if there are no tagged
  466.         files, the selected file) of the current panel
  467.         (C-x t) or of the other panel (C-x C-t) to the
  468.         command line.
  469.  
  470. C-x p, C-x C-p
  471.         the first key sequence copies the current path
  472.         name to the command line, and the second one
  473.         copies the unselected panel's path name to the
  474.         command line.
  475.  
  476. C-q      the quote command can be used to insert
  477.         characters that are otherwise interpreted by the
  478.         Midnight Commander (like the '+' symbol)
  479.  
  480. Alt-p, Alt-n
  481.         use these keys to browse through the command
  482.         history. Alt-p takes you to the last entry, Alt-n
  483.         takes you to the next one.
  484.  
  485. Alt-h    displays the history for the current input line.[General Movement Keys]
  486. General Movement Keys
  487.  
  488. The help viewer, the file viewer and the directory tree
  489. use common code to handle moving. Therefore they accept
  490. exactly the same keys. Each of them also accepts some keys
  491. of its own.
  492.  
  493. Other parts of the Midnight Commander use some of the same
  494. movement keys, so this section may be of use for those
  495. parts too.
  496.  
  497. Up, C-p  moves one line backward.
  498.  
  499. Down, C-n
  500.         moves one line forward.
  501.  
  502. Prev Page, Page Up, Alt-v
  503.         moves one page up.
  504.  
  505. Next Page, Page Down, C-v
  506.         moves one page down.
  507.  
  508. Home, A1
  509.         moves to the beginning.
  510.  
  511. End, C1  move to the end.
  512.  
  513. The help viewer and the file viewer accept the following
  514. keys in addition the to ones mentioned above:
  515.  
  516. b, C-b, C-h, Backspace, Delete
  517.         moves one page up.
  518.  
  519. Space bar
  520.         moves one page down.
  521.  
  522. u, d     moves one half of a page up or down.
  523.  
  524. g, G     moves to the beginning or to the end.[Input Line Keys]
  525. Input Line Keys
  526.  
  527. The input lines (they are used for the command lineShell Command Line and
  528. for the query dialogs in the program) accept these keys:
  529.  
  530. C-a      puts the cursor at the beginning of line.
  531.  
  532. C-e      puts the cursor at the end of the line.
  533.  
  534. C-b, move-left
  535.         move the cursor one position left.
  536.  
  537. C-f, move-right
  538.         move the cursor one position right.
  539.  
  540. Alt-f    moves one word forward.
  541.  
  542. Alt-b    moves one word backward.
  543.  
  544. C-h, backspace
  545.         delete the previous character.
  546.  
  547. C-d, Delete
  548.         delete the character in the point (over the
  549.         cursor).
  550.  
  551. C-@      sets the mark for cutting.
  552.  
  553. C-w      copies the text between the cursor and the mark
  554.         to a kill buffer and removes the text from the
  555.         input line.
  556.  
  557. Alt-w    copies the text between the cursor and the mark
  558.         to a kill buffer.
  559.  
  560. C-y      yanks back the contents of the kill buffer.
  561.  
  562. C-k      kills the text from the cursor to the end of the
  563.         line.
  564.  
  565. Alt-p, Alt-n
  566.         Use these keys to browse through the command
  567.         history. Alt-p takes you to the last entry, Alt-n
  568.         takes you to the next one.
  569.  
  570. Alt-C-h, Alt-Backspace
  571.         delete one word backward.
  572.  
  573. Alt-Tab  does the filename, command, variable, username
  574.         and hostname completionCompletion for you.
  575.  
  576. [Menu Bar]
  577. Menu Bar
  578.  
  579. The menu bar pops up when you press F9 or click the mouse
  580. on the top row of the screen. The menu bar has five menus:
  581. "Left", "File", "Command", "Options" and "Right".
  582.  
  583. The Left and Right MenusLeft and Right Menus allow you to modify the
  584. appearance of the left and right directory panels.
  585.  
  586. The File MenuFile Menu lists the actions you can perform on the
  587. currently selected file or the tagged files.
  588.  
  589. The Command MenuCommand Menu lists the actions which are more general
  590. and bear no relation to the currently selected file or the
  591. tagged files.
  592.  
  593. The Options MenuOptions Menu lists the actions which allow you to
  594. customize the Midnight Commander.[Left and Right Menus]
  595. Left and Right (Above and Below) Menus
  596.  
  597. The outlook of the directory panels can be changed from
  598. the Left  and Right  menus (they are named Above  and Below
  599. when the horizontal panel split is chosen from the LayoutLayout
  600. options dialog).[Listing Mode...]
  601. Listing Mode...
  602.  
  603. The listing mode view is used to display a listing of
  604. files, there are four different listing modes available:
  605. Full , Brief , Long  and User . The full directory view shows
  606. the file name, the size of the file and the modification
  607. time.
  608.  
  609. The brief view shows only the file name and it has two
  610. columns (therefore showing twice as many files as other
  611. views). The long view is similar to the output of "ls -l"
  612. command. The long view takes the whole screen width.
  613.  
  614. If you choose the "User" display format, then you have to
  615. specify the display format.
  616.  
  617. The user display format must start with a panel size
  618. specifier. This may be "half" or "full", and they specify
  619. a half screen panel and a full screen panel respectively.
  620.  
  621. After the panel size, you may specify the two columns mode
  622. on the panel, this is done by adding the number "2" to the
  623. user format string.
  624.  
  625. After this you add the name of the fields with an optional
  626. size specifier. This are the available fields you may
  627. display:
  628.  
  629. name     displays the file name.
  630.  
  631. size     displays the file size.
  632.  
  633. bsize    is an alternative form of the size  format. It
  634.         displays the size of the files and for
  635.         directories it just shows SUB-DIR or UP--DIR.
  636.  
  637. type     displays a one character wide type field. This
  638.         character is similar to what is displayed by ls
  639.         with the -F flag - *  for executable files, /  for
  640.         directories, @  for links, =  for sockets, -  for
  641.         character devices, +  for block devices, |  for
  642.         pipes, ~  for symbolic links to directories and !
  643.         for stale symlinks (links that point nowhere).
  644.  
  645. mark     an asterisk if the file is tagged, a space if
  646.         it's not.
  647.  
  648. mtime    file's last modification time.
  649.  
  650. atime    file's last access time.
  651.  
  652. ctime    file's status change time.
  653.  
  654. perm     a string representing the current permission bits
  655.         of the file.
  656.  
  657. mode     an octal value with the current permission bits
  658.         of the file.
  659.  
  660. nlink    the number of links to the file.
  661.  
  662. ngid     the GID (numeric).
  663.  
  664. nuid     the UID (numeric).
  665.  
  666. owner    the owner of the file.
  667.  
  668. group    the group of the file.
  669.  
  670. inode    the inode of the file.
  671.  
  672. Also you can use following keywords to define the panel
  673. layout:
  674.  
  675. space    a space in the display format.
  676.  
  677. |        add a vertical line to the display format.
  678.  
  679. To force one field to a fixed size (a size specifier), you
  680. just add :  followed by the number of characters you want
  681. the field to have. If the number is followed by the symbol
  682. + , then the size specifies the minimal field size - if the
  683. program finds out that there is more space on the screen,
  684. it will then expand that field.
  685.  
  686. For example, the Full  display corresponds to this format:
  687.  
  688. half type name | size | mtime
  689.  
  690. And the Long  display corresponds to this format:
  691.  
  692. full perm space nlink space owner space group space size
  693. space mtime space name
  694.  
  695. This is a nice user display format:
  696.  
  697. half name | size:7 | type mode:3
  698.  
  699. Panels may also be set to the following modes:
  700.  
  701. "Info"   The info view display information related to the
  702.         currently selected file and if possible
  703.         information about the current file system.
  704.  
  705. "Tree"   The tree view is quite similar to the directory
  706.         treeDirectory Tree feature. See the section about it for more
  707.         information.
  708.  
  709. "Quick View"
  710.         In this mode, the panel will switch to a reduced
  711.         viewerInternal File Viewer that displays the contents of the
  712.         currently selected file, if you select the panel
  713.         (with the tab key or the mouse), you will have
  714.         access to the usual viewer commands.[Sort Order...]
  715. Sort Order...
  716.  
  717. The eight sort orders are by name, by extension, by
  718. modification time, by access time, and by inode
  719. information modification time, by size, by inode and
  720. unsorted. In the Sort order dialog box you can choose the
  721. sort order and you may also specify if you want to sort in
  722. reverse order by checking the reverse box.
  723.  
  724. By default directories are sorted before files but this
  725. can be changed from the Options menuOptions Menu (option Mix all
  726. files ).[Filter...]
  727. Filter...
  728.  
  729. The filter command allows you to specify a shell pattern
  730. (for example *.tar.gz ) which the files must match to be
  731. shown. Regardless of the filter pattern, the directories
  732. and the links to directories are always shown in the
  733. directory panel.[Reread]
  734. Reread
  735.  
  736. The reread command reload the list of files in the
  737. directory. It is useful if other processes have created or
  738. removed files. If you have panelized file names in a panel
  739. this will reload the directory contents and remove the
  740. panelized information (See the section External panelizeExternal panelize
  741. for more information).[File Menu]
  742. File Menu
  743.  
  744. The Midnight Commander uses the F1 - F10 keys as keyboard
  745. shortcuts for commands appearing in the file menu. The
  746. escape sequences for the function keys are terminfo
  747. capabilities kf1 trough kf10. On terminals without
  748. function key support, you can achieve the same
  749. functionality by pressing the ESC key and then a number in
  750. the range 1 through 9 and 0 (corresponding to F1 to F9 and
  751. F10 respectively).
  752.  
  753. The File menu has the following commands (keyboard
  754. shortcuts in parentheses):
  755.  
  756. Help (F1)
  757.  
  758. Invokes the built-in hypertext help viewer. Inside the
  759. help viewerContents, you can use the Tab key to select the next
  760. link and the Enter key to follow that link. The keys Space
  761. and Backspace are used to move forward and backward in a
  762. help page. Press F1 again to get the full list of accepted
  763. keys.
  764.  
  765. Menu (F2)
  766.  
  767. Invoke the user menuMenu File Edit. The user menu provides an easy way
  768. to provide users with a menu and add extra features to the
  769. Midnight Commander.
  770.  
  771. View (F3, Shift-F3)
  772.  
  773. View the currently selected file. By default this invokes
  774. the Internal File ViewerInternal File Viewer but if the option "Use internal
  775. view" is off, it invokes an external file viewer specified
  776. by the VIEWER  environment variable. If VIEWER  is
  777. undefined, the PAGER  environment variable is tried. If
  778. PAGER  is also undefined, the "view" command is invoked. If
  779. you use Shift-F3 instead, the viewer will be invoked
  780. without doing any formatting or preprocessing to the file.
  781.  
  782. Filtered View (Alt-!)
  783.  
  784. This command prompts for a command and its arguments (the
  785. argument defaults to the currently selected file name),
  786. the output from such command is shown in the internal file
  787. viewer.
  788.  
  789. Edit (F4, F14)
  790.  
  791. Press F4 to edit the highlighted file. Press F14 (usually
  792. Shift-F4) to start the editor with a new, empty file.
  793. Currently they invoke the vi  editor, or the editor
  794. specified in the EDITOR  environment variable, or the
  795. Internal File EditorInternal File Editor if the use_internal_edit option is
  796. on.
  797.  
  798. Copy (F5, F15)
  799.  
  800. Press F5 to pop up an input dialog to copy the currently
  801. selected file (or the tagged files, if there is at least
  802. one file tagged) to the directory/filename you specify in
  803. the input dialog. The destination defaults to the
  804. directory in the non-selected panel. During this process,
  805. you can press C-c or ESC to abort the operation. For
  806. details about source mask (which will be usually either *
  807. or ^\(.*\)$ depending on setting of Use shell patterns)
  808. and possible wildcards in the destination see Mask
  809. copy/renameMask Copy/Rename.
  810.  
  811. F15 (usually Shift-F5) is similar, but defaults to the
  812. directory in the selected panel. It always operates on the
  813. selected file, regardless of any tagged files.
  814.  
  815. On some systems, it is possible to do the copy in the
  816. background by clicking on the background button (or
  817. pressing Alt-b in the dialog box). The Background JobsBackground jobs is
  818. used to control the background process.
  819.  
  820. Link (C-x l)
  821.  
  822. Create a hard link to the current file.
  823.  
  824. SymLink (C-x s)
  825.  
  826. Create a symbolic link to the current file. To those of
  827. you who don't know what links are: creating a link to a
  828. file is a bit like copying the file, but both the source
  829. filename and the destination filename represent the same
  830. file image. For example, if you edit one of these files,
  831. all changes you make will appear in both files. Some
  832. people call links aliases or shortcuts.
  833.  
  834. A hard link appears as a real file. After making it, there
  835. is no way of telling which one is the original and which
  836. is the link. If you delete either one of them the other
  837. one is still intact. It is very difficult to notice that
  838. the files represent the same image. Use hard links when
  839. you don't even want to know.
  840.  
  841. A symbolic link is a reference to the name of the original
  842. file. If the original file is deleted the symbolic link is
  843. useless. It is quite easy to notice that the files
  844. represent the same image. The Midnight Commander shows an
  845. "@"-sign in front of the file name if it is a symbolic
  846. link to somewhere (except to directory, where it shows a
  847. tilde (~)). The original file which the link points to is
  848. shown on mini-status line if the "Show mini-status"  option
  849. is enabled. Use symbolic links when you want to avoid the
  850. confusion that can be caused by hard links.
  851.  
  852. Rename/Move (F6, F16)
  853.  
  854. Press F6 to pop up an input dialog to copy the currently
  855. selected file (or the tagged files, if there is at least
  856. one file tagged) to the directory/filename you specify in
  857. the input dialog. The destination defaults to the
  858. directory in the non-selected panel. For more details look
  859. at Copy (F5) operation above, most of the things are quite
  860. similar.
  861.  
  862. F16 (usually Shift-F6) is similar, but defaults to the
  863. directory in the selected panel. It always operates on the
  864. selected file, regardless of any tagged files.
  865.  
  866. On some systems, it is possible to do the copy in the
  867. background by clicking on the background button (or
  868. pressing Alt-b in the dialog box). The Background JobsBackground jobs is
  869. used to control the background process.
  870.  
  871. Mkdir (F7)
  872.  
  873. Pop up an input dialog and creates the directory
  874. specified.
  875.  
  876. Delete (F8)
  877.  
  878. Delete the currently selected file or the tagged files in
  879. the currently selected panel. During the process, you can
  880. press C-c or ESC to abort the operation.
  881.  
  882. Quick cd (Alt-c)  Use the quick cdQuick cd command if you have
  883. full command line and want to cd somewhere.
  884.  
  885. Select group (+)
  886.  
  887. This is used to select (tag) a group of files. The
  888. Midnight Commander will prompt for a regular expression
  889. describing the group. When Shell Patterns  are enabled, the
  890. regular expression is much like the filename globbing in
  891. the shell (* standing for zero or more characters and ?
  892. standing for one character). If Shell Patterns  is off,
  893. then the tagging of files is done with normal regular
  894. expressions (see ed (1)).
  895.  
  896. To mark directories instead of files, the expression must
  897. start or end with a '/'.
  898.  
  899. Unselect group (\)
  900.  
  901. Used to unselect a group of files. This is the opposite of
  902. the "Select group"  command.
  903.  
  904. Quit (F10, Shift-F10)
  905.  
  906. Terminate the Midnight Commander. Shift-F10 is used when
  907. you want to quit and you are using the shell wrapper.
  908. Shift-F10 will not take you to the last directory you
  909. visited with the Midnight Commander, instead it will stay
  910. at the directory where you started the Midnight Commander.[Quick cd]
  911. Quick cd
  912.  
  913. This command is useful if you have a full command line and
  914. want to cdThe cd internal command somewhere without having to yank and paste
  915. the command line. This command pops up a small dialog,
  916. where you enter everything you would enter after cd  on the
  917. command line and then you press enter. This features all
  918. the things that are already in the internal cd commandThe cd internal command.[Command Menu]
  919. Command Menu
  920.  
  921. The Directory treeDirectory Tree command shows a tree figure of the
  922. directories.
  923.  
  924. The Find fileFind File command allows you to search for a specific
  925. file.
  926.  
  927. The "Swap panels" command swaps the contents of the two
  928. directory panels.
  929.  
  930. The "Panels on/off" command shows the output of the last
  931. shell command. This works only on xterm and on Linux and
  932. FreeBSD console.
  933.  
  934. The Compare directories (C-x d) command compares the
  935. directory panels with each other. You can then use the
  936. Copy (F5) command to make the panels identical. There are
  937. three compare methods. The quick method compares only file
  938. size and file date. The thorough method makes a full
  939. byte-by-byte compare. The thorough method is not available
  940. if the machine does not support the mmap(2) system call.
  941. The size-only compare method just compares the file sizes
  942. and does not check the contents or the date times, it just
  943. checks the file size.
  944.  
  945. The Command history command shows a list of typed
  946. commands. The selected command is copied to the command
  947. line. The command history can also be accessed by typing
  948. Alt-p or Alt-n.
  949.  
  950. The Directory hotlist (C-\)Hotlist command makes changing of the
  951. current directory to often used directories faster.
  952.  
  953. The External panelizeExternal panelize allows you to execute an external
  954. program, and make the output of that program the contents
  955. of the current panel.
  956.  
  957. Extension file editExtension File Edit command allows you to specify
  958. programs to executed when you try to execute, view, edit
  959. and do a bunch of other thing on files with certain
  960. extensions (filename endings). The Menu file editMenu File Edit
  961. command may be used for editing the user menu (which
  962. appears by pressing F2).[Directory Tree]
  963. Directory Tree
  964.  
  965. The Directory Tree command shows a tree figure of the
  966. directories. You can select a directory from the figure
  967. and the Midnight Commander will change to that directory.
  968.  
  969. There are two ways to invoke the tree. The real directory
  970. tree command is available from Commands menu. The other
  971. way is to select tree view from the Left or Right menu.
  972.  
  973. To get rid of long delays the Midnight Commander creates
  974. the tree figure by scanning only a small subset of all the
  975. directories. If the directory which you want to see is
  976. missing, move to its parent directory and press C-r (or
  977. F2).
  978.  
  979. You can use the following keys:
  980.  
  981. General movement keysGeneral Movement Keys are accepted.
  982.  
  983. Enter.  In the directory tree, exits the directory tree and
  984. changes to this directory in the current panel. In the
  985. tree view, changes to this directory in the other panel
  986. and stays in tree view mode in the current panel.
  987.  
  988. C-r, F2 (Rescan).  Rescan this directory. Use this when the
  989. tree figure is out of date: it is missing subdirectories
  990. or shows some subdirectories which don't exist any more.
  991.  
  992. F3 (Forget).  Delete this directory from the tree figure.
  993. Use this to remove clutter from the figure. If you want
  994. the directory back to the tree figure press F2 in its
  995. parent directory.
  996.  
  997. F4 (Static/Dynamic).  Toggle between the dynamic navigation
  998. mode (default) and the static navigation mode.
  999.  
  1000. In the static navigation mode you can use the Up and Down
  1001. keys to select a directory. All known directories are
  1002. shown.
  1003.  
  1004. In the dynamic navigation mode you can use the Up and Down
  1005. keys to select a sibling directory, the Left key to move
  1006. to the parent directory, and the Right key to move to a
  1007. child directory. Only the parent, sibling and children
  1008. directories are shown, others are left out. The tree
  1009. figure changes dynamically as you traverse.
  1010.  
  1011. F5 (Copy).  Copy the directory.
  1012.  
  1013. F6 (RenMov).  Move the directory.
  1014.  
  1015. F7 (Mkdir).  Make a new directory below this directory.
  1016.  
  1017. F8 (Delete).  Delete this directory from the file system.
  1018.  
  1019. C-s, Alt-s.  Search the next directory matching the search
  1020. string. If there is no such directory these keys will move
  1021. one line down.
  1022.  
  1023. C-h, Backspace.  Delete the last character of the search
  1024. string.
  1025.  
  1026. Any other character.  Add the character to the search
  1027. string and move to the next directory which starts with
  1028. these characters. In the tree view you must first activate
  1029. the search mode by pressing C-s. The search string is
  1030. shown in the mini status line.
  1031.  
  1032. The following actions are available only in the directory
  1033. tree. They aren't supported in the tree view.
  1034.  
  1035. F1 (Help).  Invoke the help viewer and show this section.
  1036.  
  1037. Esc, F10.  Exit the directory tree. Do not change the
  1038. directory.
  1039.  
  1040. The mouse is supported. A double-click behaves like Enter.
  1041. See also the section on mouse supportMouse Support.[Find File]
  1042. Find File
  1043.  
  1044. The Find File feature first asks for the start directory
  1045. for the search and the filename to be searched for. By
  1046. pressing the Tree button you can select the start
  1047. directory from the directory treeDirectory Tree figure.
  1048.  
  1049. The contents field accepts regular expressions similar to
  1050. egrep(1). That means you have to escape characters with a
  1051. special meaning to egrep with "\", e.g. if you search for
  1052. "strcmp (" you will have to input "strcmp \(" (without the
  1053. double quotes).
  1054.  
  1055. You can start the search by pressing the OK button. During
  1056. the search you can stop from the Stop button and continue
  1057. from the Start button.
  1058.  
  1059. You can browse the filelist with the up and down arrow
  1060. keys. The Chdir button will change to the directory of the
  1061. currently selected file. The Again button will ask for the
  1062. parameters for a new search. The Quit button quits the
  1063. search operation. The Panelize button will place the found
  1064. files to the current directory panel so that you can do
  1065. additional operations on them (view, copy, move, delete
  1066. and so on). After panelizing you can press C-r to return
  1067. to the normal file listing.
  1068.  
  1069. It is possible to have a list of directories that the Find
  1070. File command should skip during the search (for example,
  1071. you may want to avoid searches on a CD-ROM or on a NFS
  1072. directory that is mounted across a slow link).
  1073.  
  1074. Directories to be skipped should be set on the variable
  1075. find_ignore_dirs  in the Misc  section of your ~/.mc/ini
  1076. file.
  1077.  
  1078. Directory components should be separated with a colon,
  1079. here is an example:
  1080.  
  1081. [Misc]
  1082. find_ignore_dirs=/cdrom:/nfs/wuarchive:/afs
  1083.  
  1084. You may consider using the External panelizeExternal panelize command for
  1085. some operations. Find file command is for simple queries
  1086. only, while using External panelize you can do as
  1087. mysterious searches as you would like.[External panelize]
  1088. External panelize
  1089.  
  1090. The External panelize allows you to execute an external
  1091. program, and make the output of that program the contents
  1092. of the current panel.
  1093.  
  1094. For example, if you want to manipulate in one of the
  1095. panels all the symbolic links in the current directory,
  1096. you can use external panelization to run the following
  1097. command:
  1098.  
  1099. find . -type l -print
  1100.  
  1101. Upon command completion, the directory contents of the
  1102. panel will no longer be the directory listing of the
  1103. current directory, but all the files that are symbolic
  1104. links.
  1105.  
  1106. If you want to panelize all of the files that have been
  1107. downloaded from your FTP server, you can use this awk
  1108. command to extract the file name from the transfer log
  1109. files:
  1110.  
  1111. awk '$9 ~! /incoming/ { print $9 }' < /usr/adm/xferlog
  1112.  
  1113. You may want to save often used panelize commands under a
  1114. descriptive name, so that you can recall them quickly. You
  1115. do this by typing the command on the input line and
  1116. pressing Add new button. Then you enter a name under which
  1117. you want the command to be saved. Next time, you just
  1118. choose that command from the list and do not have to type
  1119. it again.[Hotlist]
  1120. Hotlist
  1121.  
  1122. The Directory hotlist command shows the labels of the
  1123. directories in the directory hotlist. The Midnight
  1124. Commander will change to the directory corresponding to
  1125. the selected label. From the hotlist dialog, you can
  1126. remove already created label/directory pairs and add new
  1127. ones. To add new directories quickly, you can use the Add
  1128. to hotlist command (C-x h), which adds the current
  1129. directory into the directory hotlist, asking just for the
  1130. label for the directory.
  1131.  
  1132. This makes cd to often used directories faster. You may
  1133. consider using the CDPATH variable as described in
  1134. internal cd commandThe cd internal command description.[Extension File Edit]
  1135. Extension File Edit
  1136.  
  1137. This will invoke your editor on the file ~/.mc/bindings .
  1138. The format of this file following:
  1139.  
  1140. All lines starting with # or empty lines are thrown away.
  1141.  
  1142. Lines starting in the first column should have following
  1143. format:
  1144.  
  1145. keyword/expr , i.e. everything after the slash until new
  1146. line is expr .
  1147.  
  1148. keyword  can be:
  1149.  
  1150. shell    - expr  is an extension (no wildcards). File
  1151.         matches it its name ends with expr . Example:
  1152.         shell/.tar  matches *.tar .
  1153.  
  1154. regex    - expr  is a regular expression. File matches if
  1155.         its name matches the regular expression.
  1156.  
  1157. directory
  1158.         - expr  is a regular expression. File matches if
  1159.         it is a directory and its name matches the
  1160.         regular expression.
  1161.  
  1162. type     - expr  is a regular expression. File matches if
  1163.         the output of file %f  without the initial
  1164.         "filename:" part matches regular expression expr .
  1165.  
  1166. default  - matches any file. expr  is ignored.
  1167.  
  1168. include  - denotes a common section. expr  is the name of
  1169.         the section.
  1170.  
  1171. Other lines should start with a space or tab and should be
  1172. of the format: keyword=command  (with no spaces around =),
  1173. where keyword  should be: Open  (invoked on Enter or double
  1174. click), View  (F3), Edit  (F4) or Include  (to add rules from
  1175. the common section). command  is any one-line shell
  1176. command, with the simple macro substitutionMacro Substitution.
  1177.  
  1178. Rules are matched from top to bottom, thus the order is
  1179. important. If the appropriate action is missing, search
  1180. continues as if this rule didn't match (i.e. if a file
  1181. matches the first and second entry and View action is
  1182. missing in the first one, then on pressing F3 the View
  1183. action from the second entry will be used). default  should
  1184. match all the actions.[Background jobs]
  1185. Background Jobs
  1186.  
  1187. This lets you control the state of any background Midnight
  1188. Commander process (only copy and move files operations can
  1189. be done in the background). You can stop, restart and kill
  1190. a background job from here.[Menu File Edit]
  1191. Menu File Edit
  1192.  
  1193. The user menu is a menu of useful actions that can be
  1194. customized by the user. When you access the user menu, the
  1195. file .mc.menu from the current directory is used if it
  1196. exists, but only if it is owned by user or root and is not
  1197. world-writable. If no such file found, ~/.mc/menu is tried
  1198. in the same way, and otherwise mc uses the default
  1199. system-wide menu /etc/mc/mc.menu.
  1200.  
  1201. The format of the menu file is very simple. Lines that
  1202. start with anything but space or tab are considered
  1203. entries for the menu (in order to be able to use it like a
  1204. hot key, the first character should be a letter). All the
  1205. lines that start with a space or a tab are the commands
  1206. that will be executed when the entry is selected.
  1207.  
  1208. When an option is selected all the command lines of the
  1209. option are copied to a temporary file in the temporary
  1210. directory (usually /usr/tmp) and then that file is
  1211. executed. This allows the user to put normal shell
  1212. constructs in the menus. Also simple macro substitution
  1213. takes place before executing the menu code. For more
  1214. information, see macro substitutionMacro Substitution.
  1215.  
  1216. Here is a sample mc.menu file:
  1217.  
  1218. A    Dump the currently selected file
  1219.     od -c %f
  1220.  
  1221. B    Edit a bug report and send it to root
  1222.     I=`mktemp ${MC_TMPDIR:-/tmp}/mail.XXXXXX` || exit 1
  1223.     vi $I
  1224.     mail -s "Midnight Commander bug" root < $I
  1225.     rm -f $I
  1226.  
  1227. M    Read mail
  1228.     emacs -f rmail
  1229.  
  1230. N    Read Usenet news
  1231.     emacs -f gnus
  1232.  
  1233. H    Call the info hypertext browser
  1234.     info
  1235.  
  1236. J    Copy current directory to other panel recursively
  1237.     tar cf - . | (cd %D && tar xvpf -)
  1238.  
  1239. K    Make a release of the current subdirectory
  1240.     echo -n "Name of distribution file: "
  1241.     read tar
  1242.     ln -s %d `dirname %d`/$tar
  1243.     cd ..
  1244.     tar cvhf ${tar}.tar $tar
  1245.  
  1246. = f *.tar.gz | f *.tgz & t n
  1247. X       Extract the contents of a compressed tar file
  1248.     tar xzvf %f
  1249.  
  1250. Default Conditions
  1251.  
  1252. Each menu entry may be preceded by a condition. The
  1253. condition must start from the first column with a '='
  1254. character. If the condition is true, the menu entry will
  1255. be the default entry.
  1256.  
  1257. Condition syntax:     = <sub-cond>
  1258.   or:            = <sub-cond> | <sub-cond> ...
  1259.   or:            = <sub-cond> & <sub-cond> ...
  1260.  
  1261. Sub-condition is one of following:
  1262.  
  1263.   y <pattern>        syntax of current file matching pattern?
  1264.             (for edit menu only)
  1265.   f <pattern>        current file matching pattern?
  1266.   F <pattern>        other file matching pattern?
  1267.   d <pattern>        current directory matching pattern?
  1268.   D <pattern>        other directory matching pattern?
  1269.   t <type>        current file of type?
  1270.   T <type>        other file of type?
  1271.   x <filename>        is it executable filename?
  1272.   ! <sub-cond>        negate the result of sub-condition
  1273.  
  1274. Pattern is a normal shell pattern or a regular expression,
  1275. according to the shell patterns option. You can override
  1276. the global value of the shell patterns option by writing
  1277. "shell_patterns=x" on the first line of the menu file
  1278. (where "x" is either 0 or 1).
  1279.  
  1280. Type is one or more of the following characters:
  1281.  
  1282.   n    not a directory
  1283.   r    regular file
  1284.   d    directory
  1285.   l    link
  1286.   c    character device
  1287.   b    block device
  1288.   f    FIFO (pipe)
  1289.   s    socket
  1290.   x    executable file
  1291.   t    tagged
  1292.  
  1293. For example 'rlf' means either regular file, link or fifo.
  1294. The 't' type is a little special because it acts on the
  1295. panel instead of the file. The condition '=t t' is true if
  1296. there are tagged files in the current panel and false if
  1297. not.
  1298.  
  1299. If the condition starts with '=?' instead of '=' a debug
  1300. trace will be shown whenever the value of the condition is
  1301. calculated.
  1302.  
  1303. The conditions are calculated from left to right. This
  1304. means
  1305.     = f *.tar.gz | f *.tgz & t n
  1306. is calculated as
  1307.     ( (f *.tar.gz) | (f *.tgz) ) & (t n)
  1308.  
  1309. Here is a sample of the use of conditions:
  1310.  
  1311. = f *.tar.gz | f *.tgz & t n
  1312. L    List the contents of a compressed tar-archive
  1313.     gzip -cd %f | tar xvf -
  1314.  
  1315. Addition Conditions
  1316.  
  1317. If the condition begins with '+' (or '+?') instead of '='
  1318. (or '=?') it is an addition condition. If the condition is
  1319. true the menu entry will be included in the menu. If the
  1320. condition is false the menu entry will not be included in
  1321. the menu.
  1322.  
  1323. You can combine default and addition conditions by
  1324. starting condition with '+=' or '=+' (or '+=?' or '=+?' if
  1325. you want debug trace). If you want to use two different
  1326. conditions, one for adding and another for defaulting, you
  1327. can precede a menu entry with two condition lines, one
  1328. starting with '+' and another starting with '='.
  1329.  
  1330. Comments are started with '#'. The additional comment
  1331. lines must start with '#', space or tab.[Options Menu]
  1332. Options Menu
  1333.  
  1334. The Midnight Commander has some options that may be
  1335. toggled on and off in several dialogs which are accessible
  1336. from this menu. Options are enabled if they have an
  1337. asterisk or "x" in front of them.
  1338.  
  1339. The ConfigurationConfiguration command pops up a dialog from which you
  1340. can change most of settings of the Midnight Commander.
  1341.  
  1342. The LayoutLayout command pops up a dialog from which you specify
  1343. a bunch of options how mc looks like on the screen.
  1344.  
  1345. The ConfirmationConfirmation command pops up a dialog from which you
  1346. specify which actions you want to confirm.
  1347.  
  1348. The Display bitsDisplay bits command pops up a dialog from which you
  1349. may select which characters is your terminal able to
  1350. display.
  1351.  
  1352. The Learn keysLearn keys command pops up a dialog from which you
  1353. test some keys which are not working on some terminals and
  1354. you may fix them.
  1355.  
  1356. The Virtual FSVirtual FS command pops up a dialog from which you
  1357. specify some VFS related options.
  1358.  
  1359. The Save setupSave Setup command saves the current settings of the
  1360. Left, Right and Options menus. A small number of other
  1361. settings is saved, too.[Configuration]
  1362. Configuration
  1363.  
  1364. The options in this dialog are divided into three groups:
  1365. Panel Options, Pause after run and Other Options.
  1366.  
  1367. Panel Options
  1368.  
  1369. Show Backup Files.  If enabled, the Midnight Commander will
  1370. show files ending with a tilde. Otherwise, they won't be
  1371. shown (like GNU's ls option -B).
  1372.  
  1373. Show Hidden Files.  If enabled, the Midnight Commander will
  1374. show all files that start with a dot (like ls -a).
  1375.  
  1376. Mark moves down.  If enabled, the selection bar will move
  1377. down when you mark a file (with either C-t or the Insert
  1378. key).
  1379.  
  1380. Drop down menus.  When this option is enabled, the pull
  1381. down menus will be activated as soon as you press the F9
  1382. key. Otherwise, you will only get the menu title, and you
  1383. will have to activate the menu either with the arrow keys
  1384. or with the hotkeys. It is recommended if you are using
  1385. hotkeys.
  1386.  
  1387. Mix all files.  If this option is enabled, all files and
  1388. directories are shown mixed together. If the option is
  1389. off, directories (and links to directories) are shown at
  1390. the beginning of the listing, and other files below.
  1391.  
  1392. Fast directory reload.  If this option is enabled, the
  1393. Midnight Commander will use a trick to determine if the
  1394. directory contents have changed. The trick is to reload
  1395. the directory only if the i-node of the directory has
  1396. changed; this means that reloads only happen when files
  1397. are created or deleted. If what changes is the i-node for
  1398. a file in the directory (file size changes, mode or owner
  1399. changes, etc) the display is not updated. In these cases,
  1400. if you have the option on, you have to rescan the
  1401. directory manually (with C-r).
  1402.  
  1403. Pause after run
  1404.  
  1405. After executing your commands, the Midnight Commander can
  1406. pause, so that you can examine the output of the command.
  1407. There are three possible settings for this variable:
  1408.  
  1409. Never.  Means that you do not want to see the output of
  1410. your command. If you are using the Linux or FreeBSD
  1411. console or an xterm, you will be able to see the output of
  1412. the command by typing C-o.
  1413.  
  1414. On dumb terminals.  You will get the pause message on
  1415. terminals that are not capable of showing the output of
  1416. the last command executed (any terminal that is not an
  1417. xterm or the Linux console).
  1418.  
  1419. Always.  The program will pause after executing all of your
  1420. commands.
  1421.  
  1422. Other Options
  1423.  
  1424. Verbose operation.  This toggles whether the file Copy,
  1425. Rename and Delete operations are verbose (i.e., display a
  1426. dialog box for each operation). If you have a slow
  1427. terminal, you may wish to disable the verbose operation.
  1428. It is automatically turned off if the speed of your
  1429. terminal is less than 9600 bps.
  1430.  
  1431. Compute totals.  If this option is enabled, the Midnight
  1432. Commander computes total byte sizes and total number of
  1433. files prior to any Copy, Rename and Delete operations.
  1434. This will provide you with a more accurate progress bar at
  1435. the expense of some speed. This option has no effect, if
  1436. Verbose operation  is disabled.
  1437.  
  1438. Shell Patterns.  By default the Select, Unselect and Filter
  1439. commands will use shell-like regular expressions. The
  1440. following conversions are performed to achieve this: the
  1441. '*' is replaced by '.*' (zero or more characters); the '?'
  1442. is replaced by '.' (exactly one character) and '.' by the
  1443. literal dot. If the option is disabled, then the regular
  1444. expressions are the ones described in ed(1).
  1445.  
  1446. Auto Save Setup.  If this option is enabled, when you exit
  1447. the Midnight Commander the configurable options of the
  1448. Midnight Commander are saved in the ~/.mc/ini file.
  1449.  
  1450. Auto menus.  If this option is enabled, the user menu will
  1451. be invoked at startup. Useful for building menus for
  1452. non-unixers.
  1453.  
  1454. Use internal editor.  If this option is enabled, the
  1455. built-in file editor is used to edit files. If the option
  1456. is disabled, the editor specified in the EDITOR
  1457. environment variable is used. If no editor is specified,
  1458. vi  is used. See the section on the internal file editorInternal File Editor.
  1459.  
  1460. Use internal viewer.  If this option is enabled, the
  1461. built-in file viewer is used to view files. If the option
  1462. is disabled, the pager specified in the PAGER  environment
  1463. variable is used. If no pager is specified, the view
  1464. command is used. See the section on the internal file
  1465. viewerInternal File Viewer.
  1466.  
  1467. Complete: show all.  By default the Midnight Commander pops
  1468. up all possible completionsCompletion if the completion is ambiguous
  1469. only when you press Alt-Tab  for the second time. For the
  1470. first time, it just completes as much as possible and
  1471. beeps in the case of ambiguity. Enable this option if you
  1472. want to see all possible completions even after pressing
  1473. Alt-Tab  the first time.
  1474.  
  1475. Rotating dash.  If this option is enabled, the Midnight
  1476. Commander shows a rotating dash in the upper right corner
  1477. as a work in progress indicator.
  1478.  
  1479. Lynx-like motion.  If this option is enabled, you may use
  1480. the arrows keys to automatically chdir if the current
  1481. selection is a subdirectory and the shell command line is
  1482. empty. By default, this setting is off.
  1483.  
  1484. Cd follows links.  This option, if set, causes the Midnight
  1485. Commander to follow the logical chain of directories when
  1486. changing current directory either in the panels, or using
  1487. the cd command. This is the default behavior of bash. When
  1488. unset, the Midnight Commander follows the real directory
  1489. structure, so cd .. if you've entered that directory
  1490. through a link will move you to the current directory's
  1491. real parent and not to the directory where the link was
  1492. present.
  1493.  
  1494. Safe delete.  If this option is enabled, deleting files and
  1495. directory hotlist entries unintentionally becomes more
  1496. difficult. The default selection in the confirmation
  1497. dialogs for deletion changes from "Yes" to "No". This
  1498. option is disabled by default.[Layout]
  1499. Layout
  1500.  
  1501. The layout dialog gives you a possibility to change the
  1502. general layout of screen. You can specify whether the
  1503. menubar, the command prompt, the hintbar and the function
  1504. keybar are visible. On the Linux or FreeBSD console you
  1505. can specify how many lines are shown in the output window.
  1506.  
  1507. The rest of the screen area is used for the two directory
  1508. panels. You can specify whether the area is split to the
  1509. panels in vertical or horizontal direction. The split can
  1510. be equal or you can specify an unequal split.
  1511.  
  1512. You can specify whether permissions  and file types  should
  1513. be highlighted with distinctive ColorsColors. If the permission
  1514. highlighting is enabled, the parts of the perm  and mode
  1515. display fieldsListing Mode... which apply to the user running Midnight
  1516. Commander are highlighted with the color defined by the
  1517. selected  keyword. If the file type highlighting is
  1518. enabled, files are colored according to their file type
  1519. (e.g. directory, core file, executable, and so on).
  1520.  
  1521. If the Show Mini-Status  option is enabled, one line of
  1522. status information about the currently selected item is
  1523. shown at the bottom of the panels.
  1524.  
  1525. When run in a terminal emulator for X11, Midnight
  1526. Commander sets the terminal window title to the current
  1527. working directory and updates it when necessary. If your
  1528. terminal emulator is broken and you see some incorrect
  1529. output on startup and directory change, turn off the Xterm
  1530. Window Title  option.[Confirmation]
  1531. Confirmation
  1532.  
  1533. In this menu you configure the confirmation options for
  1534. file deletion, directory hotlist entries deletion,
  1535. overwriting, execution by pressing enter and quitting the
  1536. program.[Display bits]
  1537. Display bits
  1538.  
  1539. This is used to configure the range of visible characters
  1540. on the screen. This setting may be 7-bits if your
  1541. terminal/curses supports only seven output bits,
  1542. ISO-8859-1 displays all the characters in the ISO-8859-1
  1543. map and full 8 bits is for those terminals that can
  1544. display full 8 bit characters.[Learn keys]
  1545. Learn keys
  1546.  
  1547. This dialog allows you to test and redefine functional
  1548. keys, cursor arrows and some other keys to make them work
  1549. properly on your terminal. They often don't, since many
  1550. terminal databases are incomplete or broken.
  1551.  
  1552. You can move around with the Tab key and with the vi
  1553. moving keys ('h' left, 'j' down, 'k' up and 'l' right).
  1554. Once you press any cursor movement key and it is
  1555. recognized, you can use that key as well.
  1556.  
  1557. You can test keys just by pressing each of them. When you
  1558. press a key and it is recognized properly, OK should
  1559. appear next to the name of that key. Once a key is marked
  1560. OK it starts working as usually, e.g. F1 pressed the first
  1561. time will just check that the F1 key works, but after that
  1562. it will show help. The same applies to the arrow keys. The
  1563. Tab key should be working always.
  1564.  
  1565. If some keys do not work properly then you won't see OK
  1566. appear after pressing one of these. Then you may want to
  1567. redefine it. Do it by pressing the button with the name of
  1568. that key (either by the mouse or by Enter or Space after
  1569. selecting the button with Tab or arrows). Then a message
  1570. box will appear asking you to press that key. Do it and
  1571. wait until the message box disappears. If you want to
  1572. abort, just press Escape once and wait.
  1573.  
  1574. When you finish with all the keys, you can Save them. The
  1575. definitions for the keys you have redefined will be
  1576. written into the [terminal:TERM] section of your ~/.mc/ini
  1577. file (where TERM is the name of your current terminal).
  1578. The definitions of the keys that were already working
  1579. properly are not saved.[Virtual FS]
  1580. Virtual FS
  1581.  
  1582. This option gives you control over the settings of the
  1583. Virtual File SystemVirtual File System.
  1584.  
  1585. The Midnight Commander keeps in memory the information
  1586. related to some of the virtual file systems to speed up
  1587. the access to the files in the file system (for example,
  1588. directory listings fetched from FTP servers).
  1589.  
  1590. Also, in order to access the contents of compressed files
  1591. (for example, compressed tar files) the Midnight Commander
  1592. needs to create temporary uncompressed files on your disk.
  1593.  
  1594. Since both the information in memory and the temporary
  1595. files on disk take up resources, you may want to tune the
  1596. parameters of the cached information to decrease your
  1597. resource usage or to maximize the speed of access to
  1598. frequently used file systems.
  1599.  
  1600. Because of the format of the tar archives, the Tar
  1601. filesystem  needs to read the whole file just to load the
  1602. file entries. Since most tar files are usually kept
  1603. compressed (plain tar files are species in extinction),
  1604. the tar file system has to uncompress the file on the disk
  1605. in a temporary location and then access the uncompressed
  1606. file as a regular tar file.
  1607.  
  1608. Now, since we all love to browse files and tar files all
  1609. over the disk, it's common that you will leave a tar file
  1610. and the re-enter it later. Since decompression is slow,
  1611. the Midnight Commander will cache the information in
  1612. memory for a limited time. When the timeout expires, all
  1613. the resources associated with the file system are
  1614. released. The default timeout is set to one minute.
  1615.  
  1616. The FTP File SystemFTP File System (ftpfs) allows you to browse
  1617. directories on remote FTP servers. It has several options.
  1618.  
  1619. ftp anonymous password  is the password used when you login
  1620. as "anonymous". Some sites require a valid e-mail address.
  1621. On the other hand, you probably don't want to give your
  1622. real e-mail address to untrusted sites, especially if you
  1623. are not using spam filtering.
  1624.  
  1625. ftpfs keeps the directory listing it fetches from a FTP
  1626. server in a cache. The cache expire time is configurable
  1627. with the ftpfs directory cache timeout  option. A low value
  1628. for this option may slow down every operation on the ftpfs
  1629. because every operation would require sending a request to
  1630. the FTP server.
  1631.  
  1632. You can define an FTP proxy host for doing FTP. Note that
  1633. most modern firewalls are fully transparent at least for
  1634. passive FTP (see below), so FTP proxies are considered
  1635. obsolete.
  1636.  
  1637. If Always use ftp proxy  is not set, you can use the
  1638. exclamation sign to enable proxy for certain hosts. See
  1639. FTP File SystemFTP File System for examples.
  1640.  
  1641. If this option is set, the program will do two things:
  1642. consult the /usr/lib/mc/mc.no_proxy file for lines
  1643. containing host names that are local (if the host name
  1644. starts with a dot, it is assumed to be a domain) and to
  1645. assume that any hostnames without dots in their names are
  1646. directly accessible. All other hosts will be accessed
  1647. through the specified FTP proxy.
  1648.  
  1649. You can enable using ~/.netrc  file, which keeps login
  1650. names and passwords for ftp servers. See netrc (5) for the
  1651. description of the .netrc format.
  1652.  
  1653. Use passive mode  enables using FTP passive mode, when the
  1654. connection for data transfer is initiated by the client,
  1655. not by the server. This option is recommended and enabled
  1656. by default. If this option is turned off, the data
  1657. connection is initiated by the server. This may not work
  1658. with some firewalls.[Save Setup]
  1659. Save Setup
  1660.  
  1661. At startup the Midnight Commander will try to load
  1662. initialization information from the ~/.mc/ini file. If
  1663. this file doesn't exist, it will load the information from
  1664. the system-wide configuration file, located in
  1665. /etc/mc/mc.ini. If the system-wide configuration file
  1666. doesn't exist, MC uses the default settings.
  1667.  
  1668. The Save Setup  command creates the ~/.mc/ini file by
  1669. saving the current settings of the Left, RightLeft and Right Menus and
  1670. OptionsOptions Menu menus.
  1671.  
  1672. If you activate the auto save setup  option, MC will always
  1673. save the current settings when exiting.
  1674.  
  1675. There also exist settings which can't be changed from the
  1676. menus. To change these settings you have to edit the setup
  1677. file with your favorite editor. See the section on Special
  1678. SettingsSpecial Settings for more information.
  1679.  
  1680. [Executing operating system commands]
  1681. Executing operating system commands
  1682.  
  1683. You may execute commands by typing them directly in the
  1684. Midnight Commander's input line, or by selecting the
  1685. program you want to execute with the selection bar in one
  1686. of the panels and hitting Enter.
  1687.  
  1688. If you press Enter over a file that is not executable, the
  1689. Midnight Commander checks the extension of the selected
  1690. file against the extensions in the Extensions FileExtension File Edit. If a
  1691. match is found then the code associated with that
  1692. extension is executed. A very simple macro expansionMacro Substitution
  1693. takes place before executing the command.[The cd internal command]
  1694. The cd internal command
  1695.  
  1696. The cd  command is interpreted by the Midnight Commander,
  1697. it is not passed to the command shell for execution. Thus
  1698. it may not handle all of the nice macro expansion and
  1699. substitution that your shell does, although it does some
  1700. of them:
  1701.  
  1702. Tilde substitution.  The (~) will be substituted with your
  1703. home directory, if you append a username after the tilde,
  1704. then it will be substituted with the login directory of
  1705. the specified user.
  1706.  
  1707. For example, ~guest is the home directory for the user
  1708. guest, while ~/guest is the directory guest in your home
  1709. directory.
  1710.  
  1711. Previous directory.  You can jump to the directory you were
  1712. previously by using the special directory name '-' like
  1713. this: cd -
  1714.  
  1715. CDPATH directories.  If the directory specified to the cd
  1716. command is not in the current directory, then The Midnight
  1717. Commander uses the value in the environment variable
  1718. CDPATH  to search for the directory in any of the named
  1719. directories.
  1720.  
  1721. For example you could set your CDPATH  variable to
  1722. ~/src:/usr/src, allowing you to change your directory to
  1723. any of the directories inside the ~/src and /usr/src
  1724. directories, from any place in the file system by using
  1725. its relative name (for example cd linux could take you to
  1726. /usr/src/linux).[Macro Substitution]
  1727. Macro Substitution
  1728.  
  1729. When accessing a user menuMenu File Edit, or executing an extension
  1730. dependent commandExtension File Edit, or running a command from the command
  1731. line input, a simple macro substitution takes place.
  1732.  
  1733. The macros are:
  1734.  
  1735. %i       The indent of blank space, equal the cursor
  1736.         column position. For edit menu only.
  1737.  
  1738. %y       The syntax type of current file. For edit menu
  1739.         only.
  1740.  
  1741. %k       The block file name.
  1742.  
  1743. %e       The error file name.
  1744.  
  1745. %m       The current menu name.
  1746.  
  1747. %f  and %p
  1748.         The current file name.
  1749.  
  1750. %x       The extension of current file name.
  1751.  
  1752. %b       The current file name without extension.
  1753.  
  1754. %d       The current directory name.
  1755.  
  1756. %F       The current file in the unselected panel.
  1757.  
  1758. %D       The directory name of the unselected panel.
  1759.  
  1760. %t       The currently tagged files.
  1761.  
  1762. %T       The tagged files in the unselected panel.
  1763.  
  1764. %u  and %U
  1765.         Similar to the %t and %T macros, but in addition
  1766.         the files are untagged. You can use this macro
  1767.         only once per menu file entry or extension file
  1768.         entry, because next time there will be no tagged
  1769.         files.
  1770.  
  1771. %s  and %S
  1772.         The selected files: The tagged files if there are
  1773.         any. Otherwise the current file.
  1774.  
  1775. %cd      This is a special macro that is used to change
  1776.         the current directory to the directory specified
  1777.         in front of it. This is used primarily as an
  1778.         interface to the Virtual File SystemVirtual File System.
  1779.  
  1780. %view    This macro is used to invoke the internal viewer.
  1781.         This macro can be used alone, or with arguments.
  1782.         If you pass any arguments to this macro, they
  1783.         should be enclosed in brackets.
  1784.  
  1785.         The arguments are: ascii  to force the viewer into
  1786.         ascii mode; hex  to force the viewer into hex
  1787.         mode; nroff  to tell the viewer that it should
  1788.         interpret the bold and underline sequences of
  1789.         nroff; unformatted  to tell the viewer to not
  1790.         interpret nroff commands for making the text bold
  1791.         or underlined.
  1792.  
  1793. %%       The % character
  1794.  
  1795. %{some text}
  1796.         Prompt for the substitution. An input box is
  1797.         shown and the text inside the braces is used as a
  1798.         prompt. The macro is substituted by the text
  1799.         typed by the user. The user can press ESC or F10
  1800.         to cancel. This macro doesn't work on the command
  1801.         line yet.
  1802.  
  1803. %var{ENV:default}
  1804.         If environment variable ENV  is unset, the default
  1805.         is substituted. Otherwise, the value of ENV  is
  1806.         substituted.[The subshell support]
  1807. The subshell support
  1808.  
  1809. The subshell support is a compile time option, that works
  1810. with the shells: bash, tcsh and zsh.
  1811.  
  1812. When the subshell code is activated the Midnight Commander
  1813. will spawn a concurrent copy of your shell (the one
  1814. defined in the SHELL  variable and if it is not defined,
  1815. then the one in the /etc/passwd file) and run it in a
  1816. pseudo terminal, instead of invoking a new shell each time
  1817. you execute a command, the command will be passed to the
  1818. subshell as if you had typed it. This also allows you to
  1819. change the environment variables, use shell functions and
  1820. define aliases that are valid until you quit the Midnight
  1821. Commander.
  1822.  
  1823. If you are using bash  you can specify startup commands for
  1824. the subshell in your ~/.mc/bashrc file and special
  1825. keyboard maps in the ~/.mc/inputrc file. tcsh  users may
  1826. specify startup commands in the ~/.mc/tcshrc file.
  1827.  
  1828. When the subshell code is used, you can suspend
  1829. applications at any time with the sequence C-o and jump
  1830. back to the Midnight Commander, if you interrupt an
  1831. application, you will not be able to run other external
  1832. commands until you quit the application you interrupted.
  1833.  
  1834. An extra added feature of using the subshell is that the
  1835. prompt displayed by the Midnight Commander is the same
  1836. prompt that you are currently using in your shell.
  1837.  
  1838. The OPTIONSOPTIONS section has more information on how you can
  1839. control the subshell code.[Chmod]
  1840. Chmod
  1841.  
  1842. The Chmod window is used to change the attribute bits in a
  1843. group of files and directories. It can be invoked with the
  1844. C-x c key combination.
  1845.  
  1846. The Chmod window has two parts - Permissions  and File .
  1847.  
  1848. In the File section are displayed the name of the file or
  1849. directory and its permissions in octal form, as well as
  1850. its owner and group.
  1851.  
  1852. In the Permissions section there is a set of check buttons
  1853. which correspond to the file attribute bits. As you change
  1854. the attribute bits, you can see the octal value change in
  1855. the File section.
  1856.  
  1857. To move between the widgets (buttons and check buttons)
  1858. use the arrow keys  or the Tab  key. To change the state of
  1859. the check buttons or to select a button use Space.  You can
  1860. also use the hotkeys on the buttons to quickly activate
  1861. them. Hotkeys are shown as highlighted letters on the
  1862. buttons.
  1863.  
  1864. To set the attribute bits, use the Enter key.
  1865.  
  1866. When working with a group of files or directories, you
  1867. just click on the bits you want to set or clear. Once you
  1868. have selected the bits you want to change, you select one
  1869. of the action buttons (Set marked or Clear marked).
  1870.  
  1871. Finally, to set the attributes exactly to those specified,
  1872. you can use the [Set all]  button, which will act on all
  1873. the tagged files.
  1874.  
  1875. [Marked all]  set only marked attributes to all selected
  1876. files
  1877.  
  1878. [Set marked]  set marked bits in attributes of all selected
  1879. files
  1880.  
  1881. [Clean marked]  clear marked bits in attributes of all
  1882. selected files
  1883.  
  1884. [Set]  set the attributes of one file
  1885.  
  1886. [Cancel]  cancel the Chmod command[Chown]
  1887. Chown
  1888.  
  1889. The Chown command is used to change the owner/group of a
  1890. file. The hot key for this command is C-x o.[Advanced Chown]
  1891. Advanced Chown
  1892.  
  1893. The Advanced Chown command is the ChmodChmod and ChownChown command
  1894. combined into one window. You can change the permissions
  1895. and owner/group of files at once.[File Operations]
  1896. File Operations
  1897.  
  1898. When you copy, move or delete files the Midnight Commander
  1899. shows the file operations dialog. It shows the files
  1900. currently being processed and uses up to three progress
  1901. bars. The file bar indicates the percentage of the current
  1902. file that has been processed so far. The count bar shows
  1903. how many of the tagged files have been handled. The bytes
  1904. bar indicates the percentage of the total size of the
  1905. tagged files that has been handled. If the verbose option
  1906. is off, the file and bytes bars are not shown.
  1907.  
  1908. There are two buttons at the bottom of the dialog.
  1909. Pressing the Skip button will skip the rest of the current
  1910. file. Pressing the Abort button will abort the whole
  1911. operation, the rest of the files are skipped.
  1912.  
  1913. There are three other dialogs which you can run into
  1914. during the file operations.
  1915.  
  1916. The error dialog informs about error conditions and has
  1917. three choices. Normally you select either the Skip button
  1918. to skip the file or the Abort button to abort the
  1919. operation altogether. You can also select the Retry button
  1920. if you fixed the problem from another terminal.
  1921.  
  1922. The replace dialog is shown when you attempt to copy or
  1923. move a file on the top of an existing file. The dialog
  1924. shows the dates and sizes of the both files. Press the Yes
  1925. button to overwrite the file, the No button to skip the
  1926. file, the All button to overwrite all the files, the None
  1927. button to never overwrite and the Update button to
  1928. overwrite if the source file is newer than the target
  1929. file. You can abort the whole operation by pressing the
  1930. Abort button.
  1931.  
  1932. The recursive delete dialog is shown when you try to
  1933. delete a directory which is not empty. Press the Yes
  1934. button to delete the directory recursively, the No button
  1935. to skip the directory, the All button to delete all the
  1936. directories and the None button to skip all the non-empty
  1937. directories. You can abort the whole operation by pressing
  1938. the Abort button. If you selected the Yes or All button
  1939. you will be asked for a confirmation. Type "yes" only if
  1940. you are really sure you want to do the recursive delete.
  1941.  
  1942. If you have tagged files and perform an operation on them
  1943. only the files on which the operation succeeded are
  1944. untagged. Failed and skipped files are left tagged.[Mask Copy/Rename]
  1945. Mask Copy/Rename
  1946.  
  1947. The copy/move operations let you translate the names of
  1948. files in an easy way. To do it, you have to specify the
  1949. correct source mask and usually in the trailing part of
  1950. the destination specify some wildcards. All the files
  1951. matching the source mask are copied/renamed according to
  1952. the target mask. If there are tagged files, only the
  1953. tagged files matching the source mask are renamed.
  1954.  
  1955. There are other options which you can set:
  1956.  
  1957. Follow links
  1958.  
  1959. determines whether make the symlinks and hardlinks in the
  1960. source directory (recursively in subdirectories) new links
  1961. in the target directory or whether would you like to copy
  1962. their content.
  1963.  
  1964. Dive into subdirs
  1965.  
  1966. determines the behavior when the source directory is about
  1967. to be copied, but the target directory already exists. The
  1968. default action is to copy the contents of the source
  1969. directory into the target directory. Enabling this option
  1970. causes copying the source directory itself into the target
  1971. directory.
  1972.  
  1973. For example, you want to copy directory /foo  containing
  1974. file bar  to /bla/foo , which is an already existing
  1975. directory. Normally (when Dive into subdirs  is not set),
  1976. mc would copy file /foo/bar  into the file /bla/foo/bar . By
  1977. enabling this option the /bla/foo/foo  directory will be
  1978. created, and /foo/bar  will be copied into
  1979. /bla/foo/foo/bar .
  1980.  
  1981. Preserve attributes
  1982.  
  1983. determines whether to preserve the permissions, timestamps
  1984. and (if you are root) the ownership of the original files.
  1985. If this option is not set, the current value of the umask
  1986. will be respected.
  1987.  
  1988. Use shell patterns on
  1989.  
  1990. When the shell patterns option is on you can use the '*'
  1991. and '?' wildcards in the source mask. They work like they
  1992. do in the shell. In the target mask only the '*' and
  1993. '\<digit>' wildcards are allowed. The first '*' wildcard
  1994. in the target mask corresponds to the first wildcard group
  1995. in the source mask, the second '*' corresponds to the
  1996. second group and so on. The '\1' wildcard corresponds to
  1997. the first wildcard group in the source mask, the '\2'
  1998. wildcard corresponds to the second group and so on all the
  1999. way up to '\9'. The '\0' wildcard is the whole filename of
  2000. the source file.
  2001.  
  2002. Two examples:
  2003.  
  2004. If the source mask is "*.tar.gz", the destination is
  2005. "/bla/*.tgz" and the file to be copied is "foo.tar.gz",
  2006. the copy will be "foo.tgz" in "/bla".
  2007.  
  2008. Suppose you want to swap basename and extension so that
  2009. "file.c" would become "c.file" and so on. The source mask
  2010. for this is "*.*" and the destination is "\2.\1".
  2011.  
  2012. Use shell patterns off
  2013.  
  2014. When the shell patterns option is off the MC doesn't do
  2015. automatic grouping anymore. You must use '\(...\)'
  2016. expressions in the source mask to specify meaning for the
  2017. wildcards in the target mask. This is more flexible but
  2018. also requires more typing. Otherwise target masks are
  2019. similar to the situation when the shell patterns option is
  2020. on.
  2021.  
  2022. Two examples:
  2023.  
  2024. If the source mask is "^\(.*\)\.tar\.gz$", the destination
  2025. is "/bla/*.tgz" and the file to be copied is "foo.tar.gz",
  2026. the copy will be "/bla/foo.tgz".
  2027.  
  2028. Let's suppose you want to swap basename and extension so
  2029. that "file.c" will become "c.file" and so on. The source
  2030. mask for this is "^\(.*\)\.\(.*\)$" and the destination is
  2031. "\2.\1".
  2032.  
  2033. Case Conversions
  2034.  
  2035. You can also change the case of the filenames. If you use
  2036. '\u' or '\l' in the target mask, the next character will
  2037. be converted to uppercase or lowercase correspondingly.
  2038.  
  2039. If you use '\U' or '\L' in the target mask, the next
  2040. characters will be converted to uppercase or lowercase
  2041. correspondingly up to the next '\E' or next '\U', '\L' or
  2042. the end of the file name.
  2043.  
  2044. The '\u' and '\l' are stronger than '\U' and '\L'.
  2045.  
  2046. For example, if the source mask is '*' (shell patterns on)
  2047. or '^\(.*\)$' (shell patterns off) and the target mask is
  2048. '\L\u*' the file names will be converted to have initial
  2049. upper case and otherwise lower case.
  2050.  
  2051. You can also use '\' as a quote character. For example,
  2052. '\\' is a backslash and '\*' is an asterisk.[Internal File Viewer]
  2053. Internal File Viewer
  2054.  
  2055. The internal file viewer provides two display modes: ASCII
  2056. and hex. To toggle between modes, use the F4 key.
  2057.  
  2058. The viewer will try to use the best method provided by
  2059. your system or the file type to display the information.
  2060. Some character sequences, which appear most often in
  2061. preformatted manual pages, are displayed bold and
  2062. underlined, thus making a pretty display of your files.
  2063.  
  2064. When in hex mode, the search function accepts text in
  2065. quotes and constant numbers. Text in quotes is matched
  2066. exactly after removing the quotes. Each number matches one
  2067. byte. You can mix quoted text with constants like this:
  2068.  
  2069. "String" -1 0xBB 012 "more text"
  2070.  
  2071. Note that 012 is an octal number. -1 is converted to 0xFF.
  2072.  
  2073. Here is a listing of the actions associated with each key
  2074. that the Midnight Commander handles in the internal file
  2075. viewer.
  2076.  
  2077. F1  Invoke the built-in hypertext help viewer.
  2078.  
  2079. F2  Toggle the wrap mode.
  2080.  
  2081. F4  Toggle the hex mode.
  2082.  
  2083. F5  Goto line. This will prompt you for a line number and
  2084. will display that line.
  2085.  
  2086. F6, /.  Regular expression search.
  2087.  
  2088. ?,  Reverse regular expression search.
  2089.  
  2090. F7  Normal search / hex mode search.
  2091.  
  2092. C-s, F17, n.  Start normal search if there was no previous
  2093. search expression else find next match.
  2094.  
  2095. C-r.  Start reverse search if there was no previous search
  2096. expression else find next match.
  2097.  
  2098. F8  Toggle Raw/Parsed mode: This will show the file as
  2099. found on disk or if a processing filter has been specified
  2100. in the mc.ext file, then the output from the filter.
  2101. Current mode is always the other than written on the
  2102. button label, since on the button is the mode which you
  2103. enter by that key.
  2104.  
  2105. F9  Toggle the format/unformat mode: when format mode is on
  2106. the viewer will interpret some string sequences to show
  2107. bold and underline with different colors. Also, on button
  2108. label is the other mode than current.
  2109.  
  2110. F10, Esc.  Exit the internal file viewer.
  2111.  
  2112. next-page, space, C-v.  Scroll one page forward.
  2113.  
  2114. prev-page, Alt-v, C-b, backspace.  Scroll one page
  2115. backward.
  2116.  
  2117. down-key  Scroll one line forward.
  2118.  
  2119. up-key  Scroll one line backward.
  2120.  
  2121. C-l  Refresh the screen.
  2122.  
  2123. C-o  Switch to the subshell and show the command screen.
  2124.  
  2125. !  Like C-o, but run a new shell if the subshell is not
  2126. running.
  2127.  
  2128. "[n] m"  Set the mark n.
  2129.  
  2130. "[n] r"  Jump to the mark n.
  2131.  
  2132. C-f  Jump to the next file.
  2133.  
  2134. C-b  Jump to the previous file.
  2135.  
  2136. Alt-r  Toggle the ruler.
  2137.  
  2138. It's possible to instruct the file viewer how to display a
  2139. file, look at the Extension File Edit sectionExtension File Edit[Internal File Editor]
  2140. Internal File Editor
  2141.  
  2142. The internal file editor is a full-featured full screen
  2143. editor. It can edit files up to 64 megabytes. It is
  2144. possible to edit binary files. The internal file editor is
  2145. invoked using F4  if the use_internal_edit  option is set in
  2146. the initialization file.
  2147.  
  2148. The features it presently supports are: block copy, move,
  2149. delete, cut, paste; key for key undo; pull-down menus;
  2150. file insertion; macro commands; regular expression search
  2151. and replace (and our own scanf-printf search and replace);
  2152. shift-arrow text highlighting (if supported by the
  2153. terminal); insert-overwrite toggle; word wrap; autoindent;
  2154. tunable tab size; syntax highlighting for various file
  2155. types; and an option to pipe text blocks through shell
  2156. commands like indent and ispell.
  2157.  
  2158. The editor is very easy to use and requires no tutoring.
  2159. To see what keys do what, just consult the appropriate
  2160. pull-down menu. Other keys are: Shift movement keys do
  2161. text highlighting. Ctrl-Ins  copies to the file
  2162. cooledit.clip  and Shift-Ins  pastes from cooledit.clip.
  2163. Shift-Del  cuts to cooledit.clip , and Ctrl-Del  deletes
  2164. highlighted text. Mouse highlighting also works, and you
  2165. can override the mouse as usual by holding down the shift
  2166. key while dragging the mouse to let normal terminal mouse
  2167. highlighting work.
  2168.  
  2169. To define a macro, press Ctrl-R  and then type out the key
  2170. strokes you want to be executed. Press Ctrl-R  again when
  2171. finished. You can then assign the macro to any key you
  2172. like by pressing that key. The macro is executed when you
  2173. press Ctrl-A  and then the assigned key. The macro is also
  2174. executed if you press Meta, Ctrl, or Esc and the assigned
  2175. key, provided that the key is not used for any other
  2176. function. Once defined, the macro commands go into the
  2177. file .mc/cedit/cooledit.macros  in your home directory. You
  2178. can delete a macro by deleting the appropriate line in
  2179. this file.
  2180.  
  2181. F19  will format the currently highlighted block (plain
  2182. text or C  or C++  code or another). This is controlled by
  2183. the file /usr/share/mc/edit.indent.rc  which is copied to
  2184. .mc/cedit/edit.indent.rc  in your home directory the first
  2185. time you use it.
  2186.  
  2187. You can use scanf search and replace to search and replace
  2188. a C format string. First take a look at the sscanf  and
  2189. sprintf  man pages to see what a format string is and how
  2190. it works. Consider following example. Suppose you want to
  2191. replace all occurrences of an open bracket, three comma
  2192. separated numbers, and a close bracket, with the word
  2193. apples , the third number, the word oranges  and then the
  2194. second number. Then fill in the Replace dialog box as
  2195. follows:
  2196.  
  2197.  Enter search string:
  2198.   (%d,%d,%d)
  2199.  Enter replacement string:
  2200.   apples %d oranges %d
  2201.  Enter replacement argument order:
  2202.   3,2
  2203.  
  2204. The last line specifies that the third and then the second
  2205. number are to be used in place of the first and second.
  2206.  
  2207. It is advisable to use this feature with Prompt on replace
  2208. on, because a match is thought to be found whenever the
  2209. number of arguments found matches the number given, which
  2210. is not always a real match. Scanf also treats whitespace
  2211. as being elastic. Note that the scanf format %[ is very
  2212. useful for scanning strings, and whitespace.
  2213.  
  2214. The editor also displays non-us characters (160+). When
  2215. editing binary files, you should set display bits  to 7
  2216. bits in the options menu to keep the spacing clean.[Completion]
  2217. Completion
  2218.  
  2219. Let the Midnight Commander type for you.
  2220.  
  2221. Attempt to perform completion on the text before current
  2222. position. MC attempts completion treating the text as
  2223. variable (if the text begins with $ ), username (if the
  2224. text begins with ~ ), hostname (if the text begins with @ )
  2225. or command (if you are on the command line in the position
  2226. where you might type a command, possible completions then
  2227. include shell reserved words and shell built-in commands
  2228. as well) in turn. If none of these matches, filename
  2229. completion is attempted.
  2230.  
  2231. Filename, username, variable and hostname completion works
  2232. on all input lines, command completion is command line
  2233. specific. If the completion is ambiguous (there are more
  2234. different possibilities), MC beeps and the following
  2235. action depends on the setting of the Complete: show all
  2236. option in the ConfigurationConfiguration dialog. If it is enabled, a
  2237. list of all possibilities pops up next to the current
  2238. position and you can select with the arrow keys and Enter
  2239. the correct entry. You can also type the first letters in
  2240. which the possibilities differ to move to a subset of all
  2241. possibilities and complete as much as possible. If you
  2242. press Alt-Tab  again, only the subset will be shown in the
  2243. listbox, otherwise the first item which matches all the
  2244. previous characters will be highlighted. As soon as there
  2245. is no ambiguity, dialog disappears, but you can hide it by
  2246. canceling keys Esc , F10  and left and right arrow keys. If
  2247. Complete: show allConfiguration is disabled, the dialog pops up only if
  2248. you press Alt-Tab  for the second time, for the first time
  2249. MC just beeps.[Virtual File System]
  2250. Virtual File System
  2251.  
  2252. The Midnight Commander is provided with a code layer to
  2253. access the file system; this code layer is known as the
  2254. virtual file system switch. The virtual file system switch
  2255. allows the Midnight Commander to manipulate files not
  2256. located on the Unix file system.
  2257.  
  2258. Currently the Midnight Commander is packaged with some
  2259. Virtual File Systems (VFS): the local  file system, used
  2260. for accessing the regular Unix file system; the ftpfs ,
  2261. used to manipulate files on remote systems with the FTP
  2262. protocol; the tarfs , used to manipulate tar and compressed
  2263. tar files; the undelfs , used to recover deleted files on
  2264. ext2 file systems (the default file system for Linux
  2265. systems), fish  (for manipulating files over shell
  2266. connections such as rsh and ssh) and finally the mcfs
  2267. (Midnight Commander file system), a network based file
  2268. system. If the code was compiled with smbfs  support, you
  2269. can manipulate files on remote systems with the SMB (CIFS)
  2270. protocol.
  2271.  
  2272. A generic extfs  (EXTernal virtual File System) is provided
  2273. in order to easily expand VFS capabilities using scripts
  2274. and external software.
  2275.  
  2276. The VFS switch code will interpret all of the path names
  2277. used and will forward them to the correct file system, the
  2278. formats used for each one of the file systems is described
  2279. later in their own section.[FTP File System]
  2280. FTP File System
  2281.  
  2282. The FTP File System (ftpfs) allows you to manipulate files
  2283. on remote machines. To actually use it, you can use the
  2284. FTP link  item in the menu or directly change your current
  2285. directory using the cd  command to a path name that looks
  2286. like this:
  2287.  
  2288. /#ftp:[!][user[:pass]@]machine[:port][remote-dir]
  2289.  
  2290. The user , port  and remote-dir  elements are optional. If
  2291. you specify the user  element, the Midnight Commander will
  2292. login to the remote machine as that user, otherwise it
  2293. will use anonymous login or the login name from the
  2294. ~/.netrc  file. The optional pass  element is the password
  2295. used for the connection. Using the password in the VFS
  2296. directory name is not recommended, because it can appear
  2297. on the screen in clear text and can be saved to the
  2298. directory history.
  2299.  
  2300. To enable using FTP proxy, prepend !  (an exclamation sign)
  2301. to the hostname.
  2302.  
  2303. Examples:
  2304.  
  2305.     /#ftp:ftp.nuclecu.unam.mx/linux/local
  2306.     /#ftp:tsx-11.mit.edu/pub/linux/packages
  2307.     /#ftp:!behind.firewall.edu/pub
  2308.     /#ftp:guest@remote-host.com:40/pub
  2309.     /#ftp:miguel:xxx@server/pub
  2310.  
  2311. Please check the Virtual File SystemVirtual FS dialog box for ftpfs
  2312. options.[Tar File System]
  2313. Tar File System
  2314.  
  2315. The tar file system provides you with read-only access to
  2316. your tar files and compressed tar files by using the chdir
  2317. command. To change your directory to a tar file, you
  2318. change your current directory to the tar file by using the
  2319. following syntax:
  2320.  
  2321. /filename.tar#utar/[dir-inside-tar]
  2322.  
  2323. The mc.ext file already provides a shortcut for tar files,
  2324. this means that usually you just point to a tar file and
  2325. press return to enter into the tar file, see the Extension
  2326. File EditExtension File Edit section for details on how this is done.
  2327.  
  2328. Examples:
  2329.  
  2330.     mc-3.0.tar.gz#utar/mc-3.0/vfs
  2331.     /ftp/GCC/gcc-2.7.0.tar#utar
  2332.  
  2333. The latter specifies the full path of the tar archive.[FIle transfer over SHell filesystem]
  2334. FIle transfer over SHell filesystem
  2335.  
  2336. The fish file system is a network based file system that
  2337. allows you to manipulate the files in a remote machine as
  2338. if they were local. To use this, the other side has to
  2339. either run fish server, or has to have bash-compatible
  2340. shell.
  2341.  
  2342. To connect to a remote machine, you just need to chdir
  2343. into a special directory which name is in the following
  2344. format:
  2345.  
  2346. /#sh:[user@]machine[:options]/[remote-dir]
  2347.  
  2348. The user,  options  and remote-dir  elements are optional. If
  2349. you specify the user  element, the Midnight Commander will
  2350. try to login on the remote machine as that user, otherwise
  2351. it will use your login name.
  2352.  
  2353. The options  are 'C' - use compression and 'rsh' use rsh
  2354. instead of ssh. If the remote-dir  element is present, your
  2355. current directory on the remote machine will be set to
  2356. this one.
  2357.  
  2358. Examples:
  2359.  
  2360.     /#sh:onlyrsh.mx:r/linux/local
  2361.     /#sh:joe@want.compression.edu:C/private
  2362.     /#sh:joe@noncompressed.ssh.edu/private
  2363. [Network File System]
  2364. Network File System
  2365.  
  2366. The Midnight Commander file system is a network base file
  2367. system that allows you to manipulate the files in a remote
  2368. machine as if they were local. To use this, the remote
  2369. machine must be running the mcserv(8) server program.
  2370.  
  2371. To connect to a remote machine, you just need to chdir
  2372. into a special directory which name is in the following
  2373. format:
  2374.  
  2375. /#mc:[user@]machine[:port][remote-dir]
  2376.  
  2377. The user, port  and remote-dir  elements are optional. If
  2378. you specify the user  element then the Midnight Commander
  2379. will try to logon on the remote machine as that user,
  2380. otherwise it will use your login name.
  2381.  
  2382. The port  element is used when the remote server is running
  2383. on a special port (see the mcserv(8) manual page for more
  2384. information about ports); finally, if the remote-dir
  2385. element is present, your current directory on the remote
  2386. machine will be set to this one.
  2387.  
  2388. Examples:
  2389.  
  2390.     /#mc:ftp.nuclecu.unam.mx/linux/local
  2391.     /#mc:joe@foo.edu:11321/private
  2392. [Undelete File System]
  2393. Undelete File System
  2394.  
  2395. On Linux systems, if you asked configure to use the ext2fs
  2396. undelete facilities, you will have the undelete file
  2397. system available. Recovery of deleted files is only
  2398. available on ext2 file systems. The undelete file system
  2399. is just an interface to the ext2fs library to retrieve all
  2400. of the deleted files names on an ext2fs and provides and
  2401. to extract the selected files into a regular partition.
  2402.  
  2403. To use this file system, you have to chdir into the
  2404. special file name formed by the "/#undel" prefix and the
  2405. file name where the actual file system resides.
  2406.  
  2407. For example, to recover deleted files on the second
  2408. partition of the first SCSI disk on Linux, you would use
  2409. the following path name:
  2410.  
  2411.     /#undel:sda2
  2412.  
  2413. It may take a while for the undelfs to load the required
  2414. information before you start browsing files there.[SMB File System]
  2415. SMB File System
  2416.  
  2417. The smbfs allows you to manipulate files on remote
  2418. machines with SMB (or CIFS) protocol. These include
  2419. Windows for Workgroups, Windows 9x/ME/XP, Windows NT,
  2420. Windows 2000 and Samba. To actually use it, you may try to
  2421. use the panel command "SMB link..." (accessible from the
  2422. menubar) or you may directly change your current directory
  2423. to it using the cd command to a path name that looks like
  2424. this:
  2425.  
  2426. /#smb:[user@]machine[/service][/remote-dir]
  2427.  
  2428. The user , service  and remote-dir  elements are optional.
  2429. The user , domain  and password  can be specified in an input
  2430. dialog.
  2431.  
  2432. Examples:
  2433.  
  2434.     /#smb:machine/Share
  2435.     /#smb:other_machine
  2436.     /#smb:guest@machine/Public/Irlex
  2437. [EXTernal File System]
  2438. EXTernal File System
  2439.  
  2440. extfs  allows to integrate numerous features and file types
  2441. into GNU Midnight Commander in an easy way, by writing
  2442. scripts.
  2443.  
  2444. Extfs filesystems can be divided into two categories:
  2445.  
  2446. 1. Stand-alone filesystems, which are not associated with
  2447. any existing file. They represent certain system-wide data
  2448. as a directory tree. You can invoke them by typing  'cd
  2449. #fsname ' where fsname is an extfs short name (see below).
  2450. Examples of such filesystems include audio (list audio
  2451. tracks on the CD) or apt (list of all Debian packages in
  2452. the system).
  2453.  
  2454. For example, to list CD-Audio tracks on your CD-ROM drive,
  2455. type
  2456.  
  2457.   cd #audio
  2458.  
  2459. 2. 'Archive' filesystems (like rpm, patchfs and more),
  2460. which represent contents of a file as a directory tree. It
  2461. can consist of 'real' files compressed in an archive
  2462. (urar, rpm) or virtual files, like messages in a mailbox
  2463. (mailfs) or parts of a patch (patchfs). To access such
  2464. filesystems  '#fsname ' should be appended to the archive
  2465. name. Note that the archive itself can be on another vfs.
  2466.  
  2467. For example, to list contents of a zip archive
  2468. documents.zip type
  2469.  
  2470.   cd documents.zip#uzip
  2471.  
  2472. In many aspects, you could treat extfs like any other
  2473. directory. For instance, you can add it to the hotlist or
  2474. change to it from directory history. An important
  2475. limitation is that you cannot invoke shell commands inside
  2476. extfs, just like any other non-local VFS.
  2477.  
  2478. Common extfs scripts included with Midnight Commander are:
  2479.  
  2480. a        access 'A:' DOS/Windows diskette  (cd #a ).
  2481.  
  2482. apt      front end to Debian's APT package management
  2483.         system  (cd #apt ).
  2484.  
  2485. audio    audio CD ripping and playing  (cd #audio  or cd
  2486.         device#audio ).
  2487.  
  2488. bpp      package of Bad Penguin GNU/Linux distribution  (cd
  2489.         file.bpp#bpp ).
  2490.  
  2491. deb      package of Debian GNU/Linux distribution  (cd
  2492.         file.deb#deb ).
  2493.  
  2494. dpkg     Debian GNU/Linux installed packages  (cd #deb ).
  2495.  
  2496. hp48     view and copy files to/from a HP48 calculator  (cd
  2497.         #hp48 ).
  2498.  
  2499. lslR     browsing of lslR listings as found on many FTPs
  2500.          (cd filename#lslR ).
  2501.  
  2502. mailfs   mbox-style mailbox files support  (cd
  2503.         mailbox#mailfs ).
  2504.  
  2505. patchfs  extfs to handle unified and context diffs  (cd
  2506.         filename#patchfs ).
  2507.  
  2508. rpm      RPM package  (cd filename#rpm ).
  2509.  
  2510. rpms     RPM database management  (cd #rpms ).
  2511.  
  2512. ulha, urar, uzip, uzoo, uar, uha
  2513.         archivers  (cd archive#xxxx  where xxxx is one of:
  2514.         ulha , urar , uzip , uzoo , uar , uha ).
  2515.  
  2516. You could bind file type/extension to specified extfs as
  2517. described in the Extension File EditExtension File Edit section. Here is an
  2518. example entry for Debian packages:
  2519.  
  2520.   regex/.deb$
  2521.           Open=%cd %p#deb
  2522. [Colors]
  2523. Colors
  2524.  
  2525. The Midnight Commander will try to detect if your terminal
  2526. supports color using the terminal database and your
  2527. terminal name. Sometimes it gets confused, so you may
  2528. force color mode or disable color mode using the -c and -b
  2529. flag respectively.
  2530.  
  2531. If the program is compiled with the Slang screen manager
  2532. instead of ncurses, it will also check the variable
  2533. COLORTERM,  if it is set, it has the same effect as the -c
  2534. flag.
  2535.  
  2536. You may specify terminals that always force color mode by
  2537. adding the color_terminals  variable to the Colors section
  2538. of the initialization file. This will prevent the Midnight
  2539. Commander from trying to detect if your terminal supports
  2540. color. Example:
  2541.  
  2542. [Colors]
  2543. color_terminals=linux,xterm
  2544. color_terminals=terminal-name1,terminal-name2...
  2545.  
  2546. The program can be compiled with both ncurses and slang,
  2547. ncurses does not provide a way to force color mode:
  2548. ncurses uses just the information in the terminal
  2549. database.
  2550.  
  2551. The Midnight Commander provides a way to change the
  2552. default colors. Currently the colors are configured using
  2553. the environment variable MC_COLOR_TABLE  or the Colors
  2554. section in the initialization file.
  2555.  
  2556. In the Colors section, the default color map is loaded
  2557. from the base_color  variable. You can specify an alternate
  2558. color map for a terminal by using the terminal name as the
  2559. key in this section. Example:
  2560.  
  2561. [Colors]
  2562. base_color=
  2563. xterm=menu=magenta:marked=,magenta:markselect=,red
  2564.  
  2565. The format for the color definition is:
  2566.  
  2567.   <keyword>=<foregroundcolor>,<backgroundcolor>:<keyword>= ...
  2568.  
  2569. The colors are optional, and the keywords are: normal,
  2570. selected, marked, markselect, errors, input, reverse,
  2571. gauge. Menu colors are: menu, menusel, menuhot,
  2572. menuhotsel. Dialog colors are: dnormal, dfocus,
  2573. dhotnormal, dhotfocus. Help colors are: helpnormal,
  2574. helpitalic, helpbold, helplink, helpslink. Viewer color
  2575. is: viewunderline. Special highlighting colors are:
  2576. executable, directory, link, stalelink, device, special,
  2577. core. Editor colors are: editnormal, editbold, editmarked.
  2578.  
  2579. input  determines the color of input lines used in query
  2580. dialogs.
  2581.  
  2582. gauge  determines the color of the filled part of the
  2583. progress bar (gauge), which is used to show the user the
  2584. progress of file operations, such as copying.
  2585.  
  2586. The dialog boxes use the following colors: dnormal  is used
  2587. for the normal text, dfocus  is the color used for the
  2588. currently selected component, dhotnormal  is the color used
  2589. to differentiate the hotkey color in normal components,
  2590. whereas the dhotfocus  color is used for the highlighted
  2591. color in the currently selected component.
  2592.  
  2593. Menus use the same scheme but uses the menu, menusel,
  2594. menuhot and menuhotsel tags instead.
  2595.  
  2596. Help uses the following colors: helpnormal  is used for
  2597. normal text, helpitalic  is used for text which is
  2598. emphasized in italic in the manual page, helpbold  is used
  2599. for text which is emphasized in bold in the manual page,
  2600. helplink  is used for not selected hyperlinks and helpslink
  2601. is used for selected hyperlink.
  2602.  
  2603. Special highlight colors determine how files are displayed
  2604. when file highlighting is enabled (see the section on
  2605. LayoutLayout). directory  is used for directories or symbolic
  2606. links to directories; executable  for executable files;
  2607. link  is used for symbolic links which are neither stale
  2608. nor linked to a directory; stalelink  is used for stale
  2609. symbolic links; device  - character and block devices;
  2610. special  is used for special files, such as pipes and
  2611. sockets; core  is for core files.
  2612.  
  2613. The possible colors are: black, gray, red, brightred,
  2614. green, brightgreen, brown, yellow, blue, brightblue,
  2615. magenta, brightmagenta, cyan, brightcyan, lightgray and
  2616. white. And there is a special keyword for transparent
  2617. background. It is 'default'. The 'default' can only be
  2618. used for background color. Example:
  2619.  
  2620. [Colors]
  2621. base_color=normal=white,default:marked=magenta,default
  2622. [Special Settings]
  2623. Special Settings
  2624.  
  2625. Most of the settings of the Midnight Commander can be
  2626. changed from the menus. However, there are a small number
  2627. of settings which can only be changed by editing the setup
  2628. file.
  2629.  
  2630. These variables may be set in your ~/.mc/ini file:
  2631.  
  2632. clear_before_exec
  2633.         By default the Midnight Commander clears the
  2634.         screen before executing a command. If you would
  2635.         prefer to see the output of the command at the
  2636.         bottom of the screen, edit your ~/.mc/ini file
  2637.         and change the value of the field
  2638.         clear_before_exec to 0.
  2639.  
  2640. confirm_view_dir
  2641.         If you press F3 on a directory, normally MC
  2642.         enters that directory. If this flag is set to 1,
  2643.         then MC will ask for confirmation before changing
  2644.         the directory if you have files tagged.
  2645.  
  2646. ftpfs_retry_seconds
  2647.         This value is the number of seconds the Midnight
  2648.         Commander will wait before attempting to
  2649.         reconnect to an FTP server that has denied the
  2650.         login. If the value is zero, the login will no be
  2651.         retried.
  2652.  
  2653. max_dirt_limit
  2654.         Specifies how many screen updates can be skipped
  2655.         at most in the internal file viewer. Normally
  2656.         this value is not significant, because the code
  2657.         automatically adjusts the number of updates to
  2658.         skip according to the rate of incoming
  2659.         keystrokes. However, on very slow machines or
  2660.         terminals with a fast keyboard auto repeat, a big
  2661.         value can make screen updates too jumpy.
  2662.  
  2663.         It seems that setting max_dirt_limit to 10 causes
  2664.         the best behavior, and that is the default value.
  2665.  
  2666. mouse_move_pages
  2667.         Controls whenever scrolling with the mouse is
  2668.         done by pages or line by line on the panels.
  2669.  
  2670. mouse_move_pages_viewer
  2671.         Controls if scrolling with the mouse is done by
  2672.         pages or line by line on the internal file
  2673.         viewer.
  2674.  
  2675. old_esc_mode
  2676.         By default the Midnight Commander treats the ESC
  2677.         key as a key prefix (old_esc_mode=0). If this
  2678.         option is set (old_esc_mode=1), the ESC key will
  2679.         act as a prefix key for one second, and if no
  2680.         extra keys have arrived, then the ESC key is
  2681.         interpreted as a cancel key (ESC ESC).
  2682.  
  2683. only_leading_plus_minus
  2684.         Allow special treatment for '+', '-', '*' in the
  2685.         command line (select, unselect, reverse
  2686.         selection) only if the command line is empty. You
  2687.         don't need to quote those characters in the
  2688.         middle of the command line. On the other hand,
  2689.         you cannot use them to change selection when the
  2690.         command line is not empty.
  2691.  
  2692. panel_scroll_pages
  2693.         If set (the default), panel will scroll by half
  2694.         the display when the cursor reaches the end or
  2695.         the beginning of the panel, otherwise it will
  2696.         just scroll a file at a time.
  2697.  
  2698. show_output_starts_shell
  2699.         This variable only works if you are not using the
  2700.         subshell support. When you use the C-o keystroke
  2701.         to go back to the user screen, if this one is
  2702.         set, you will get a fresh shell. Otherwise,
  2703.         pressing any key will bring you back to the
  2704.         Midnight Commander.
  2705.  
  2706. torben_fj_mode
  2707.         If this flag is set, then the home and end keys
  2708.         will work slightly different on the panels,
  2709.         instead of moving the selection to the first and
  2710.         last files in the panels, they will act as
  2711.         follows:
  2712.  
  2713.         The home key will: Go up to the middle line, if
  2714.         below it; else go to the top line unless it is
  2715.         already on the top line, in this case it will go
  2716.         to the first file in the panel.
  2717.  
  2718.         The end key has a similar behavior: Go down to
  2719.         the middle line, if over it; else go to the
  2720.         bottom line unless you already are at the bottom
  2721.         line, in such case it will move the selection to
  2722.         the last file name in the panel.
  2723.  
  2724. use_file_to_guess_type
  2725.         If this variable is on (the default) it will
  2726.         spawn the file command to match the file types
  2727.         listed on the mc.ext fileExtension File Edit.
  2728.  
  2729. xterm_mode
  2730.         If this variable is on (default is off) when you
  2731.         browse the file system on a Tree panel, it will
  2732.         automatically reload the other panel with the
  2733.         contents of the selected directory.
  2734.  
  2735. fish_directory_timeout
  2736.         This variable holds the lifetime of a directory
  2737.         cache entry in seconds. The default value is 900
  2738.         seconds.[Terminal databases]
  2739. Terminal databases
  2740.  
  2741. The Midnight Commander provides a way to fix your system
  2742. terminal database without requiring root privileges. The
  2743. Midnight Commander searches in the system initialization
  2744. file (the mc.lib file located in the Midnight Commander
  2745. library directory) and in the ~/.mc/ini file for the
  2746. section "terminal:your-terminal-name" and then for the
  2747. section "terminal:general", each line of the section
  2748. contains a key symbol that you want to define, followed by
  2749. an equal sign and the definition for the key. You can use
  2750. the special \e form to represent the escape character and
  2751. the ^x to represent the control-x character.
  2752.  
  2753. The possible key symbols are:
  2754.  
  2755. f0 to f20     Function keys f0-f20
  2756. bs            backspace
  2757. home          home key
  2758. end           end key
  2759. up            up arrow key
  2760. down          down arrow key
  2761. left          left arrow key
  2762. right         right arrow key
  2763. pgdn          page down key
  2764. pgup          page up key
  2765. insert        the insert character
  2766. delete        the delete character
  2767. complete      to do completion
  2768.  
  2769. For example, to define the key insert to be the Escape + [
  2770. + O + p, you set this in the ini file:
  2771.  
  2772. insert=\e[Op
  2773.  
  2774. The complete  key symbol represents the escape sequences
  2775. used to invoke the completion process, this is invoked
  2776. with Alt-tab, but you can define other keys to do the same
  2777. work (on those keyboard with tons of nice and unused keys
  2778. everywhere).
  2779.  
  2780. [FILES]
  2781. FILES
  2782.  
  2783. Full paths below may vary between installations. They are
  2784. also affected by the MC_DATADIR environment variable. If
  2785. it's set, its value is used instead of /usr/share/mc in
  2786. the paths below.
  2787.  
  2788. /usr/share/mc/mc.hlp
  2789.  
  2790.         The help file for the program.
  2791.  
  2792. /etc/mc/mc.ext
  2793.  
  2794.         The default system-wide extensions file.
  2795.  
  2796. ~/.mc/bindings
  2797.  
  2798.         User's own extension, view configuration and edit
  2799.         configuration file. They override the contents of
  2800.         the system wide files if present.
  2801.  
  2802. /etc/mc/mc.ini
  2803.  
  2804.         The default system-wide setup for the Midnight
  2805.         Commander, used only if the user doesn't have his
  2806.         own ~/.mc/ini file.
  2807.  
  2808. /etc/mc/mc.lib
  2809.  
  2810.         Global settings for the Midnight Commander.
  2811.         Settings in this file affect all users, whether
  2812.         they have ~/.mc/ini or not. Currently, only
  2813.         terminal settingsTerminal databases are loaded from mc.lib.
  2814.  
  2815. ~/.mc/ini
  2816.  
  2817.         User's own setup. If this file is present then
  2818.         the setup is loaded from here instead of the
  2819.         system-wide startup file.
  2820.  
  2821. /usr/share/mc/mc.hint
  2822.  
  2823.         This file contains the hints displayed by the
  2824.         program.
  2825.  
  2826. /etc/mc/mc.menu
  2827.  
  2828.         This file contains the default system-wide
  2829.         applications menu.
  2830.  
  2831. ~/.mc/menu
  2832.  
  2833.         User's own application menu. If this file is
  2834.         present it is used instead of the system-wide
  2835.         applications menu.
  2836.  
  2837. ~/.mc/Tree
  2838.  
  2839.         The directory list for the directory tree and
  2840.         tree view features.
  2841.  
  2842. ./.mc.menu
  2843.  
  2844.         Local user-defined menu. If this file is present,
  2845.         it is used instead of the home or system-wide
  2846.         applications menu.[AVAILABILITY]
  2847. AVAILABILITY
  2848.  
  2849. The latest version of this program can be found at
  2850. ftp://ftp.gnu.org/gnu/mc/.[SEE ALSO]
  2851. SEE ALSO
  2852.  
  2853. ed(1), gpm(1), mcserv(8), terminfo(1), view(1), sh(1),
  2854. bash(1), tcsh(1), zsh(1).
  2855.  
  2856. The Midnight Commander page on the World Wide Web:
  2857.     http://www.midnight-commander.org/
  2858. [AUTHORS]
  2859. AUTHORS
  2860.  
  2861. Authors and contributors are listed in the AUTHORS file in
  2862. the source distribution.[BUGS]
  2863. BUGS
  2864.  
  2865. See the file TODO in the distribution for information on
  2866. what remains to be done.
  2867.  
  2868. If you want to report a problem with the program, please
  2869. send mail to this address: mc-devel@gnome.org.
  2870.  
  2871. Provide a detailed description of the bug, the version of
  2872. the program you are running  (mc -V  displays this
  2873. information), the operating system you are running the
  2874. program on. If the program crashes, we would appreciate a
  2875. stack trace.
  2876.  
  2877. [main]
  2878.  lqwqk     k           k     
  2879.  x x x .   x     .     x     
  2880.  x x x k lqu wqk k lqw tqk n 
  2881.  x x x x x x x x x x x x x x 
  2882.  v   v v mqv v v v mqu v v mj
  2883.      qqqqqqCommander qj 
  2884.  
  2885. This is the main help screen for GNU Midnight Commander .
  2886.  
  2887. To learn more on how to use the interactive help facility
  2888. just press EnterHow to use help.  You may want to go directly to the help
  2889. contentsContents.
  2890.  
  2891. GNU Midnight Commander is written by its authorsAUTHORS.
  2892.  
  2893. GNU Midnight Commander comes with ABSOLUTELY NO WARRANTYWarranty.
  2894. This is free software, and you are welcome to redistribute
  2895. it under terms of GNU General Public LicenseLicense.[License]
  2896.  
  2897.                 GNU GENERAL PUBLIC LICENSE
  2898.                    Version 2, June 1991
  2899.  
  2900.  Copyright (C) 1989, 1991 Free Software Foundation, Inc.
  2901.  51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  2902.  
  2903.  Everyone is permitted to copy and distribute verbatim
  2904. copies of this license document, but changing it is not
  2905. allowed.
  2906.  
  2907.                          Preamble
  2908.  
  2909.   The licenses for most software are designed to take away
  2910. your freedom to share and change it.  By contrast, the GNU
  2911. General Public License is intended to guarantee your
  2912. freedom to share and change free software--to make sure
  2913. the software is free for all its users.  This General
  2914. Public License applies to most of the Free Software
  2915. Foundation's software and to any other program whose
  2916. authors commit to using it.  (Some other Free Software
  2917. Foundation software is covered by the GNU Library General
  2918. Public License instead.)  You can apply it to your
  2919. programs, too.
  2920.  
  2921.   When we speak of free software, we are referring to
  2922. freedom, not price.  Our General Public Licenses are
  2923. designed to make sure that you have the freedom to
  2924. distribute copies of free software (and charge for this
  2925. service if you wish), that you receive source code or can
  2926. get it if you want it, that you can change the software or
  2927. use pieces of it in new free programs; and that you know
  2928. you can do these things.
  2929.  
  2930.   To protect your rights, we need to make restrictions
  2931. that forbid anyone to deny you these rights or to ask you
  2932. to surrender the rights.  These restrictions translate to
  2933. certain responsibilities for you if you distribute copies
  2934. of the software, or if you modify it.
  2935.  
  2936.   For example, if you distribute copies of such a program,
  2937. whether gratis or for a fee, you must give the recipients
  2938. all the rights that you have.  You must make sure that
  2939. they, too, receive or can get the source code.  And you
  2940. must show them these terms so they know their rights.
  2941.  
  2942.   We protect your rights with two steps: (1) copyright the
  2943. software, and (2) offer you this license which gives you
  2944. legal permission to copy, distribute and/or modify the
  2945. software.
  2946.  
  2947.   Also, for each author's protection and ours, we want to
  2948. make certain that everyone understands that there is no
  2949. warranty for this free software.  If the software is
  2950. modified by someone else and passed on, we want its
  2951. recipients to know that what they have is not the
  2952. original, so that any problems introduced by others will
  2953. not reflect on the original authors' reputations.
  2954.  
  2955.   Finally, any free program is threatened constantly by
  2956. software patents.  We wish to avoid the danger that
  2957. redistributors of a free program will individually obtain
  2958. patent licenses, in effect making the program proprietary.
  2959. To prevent this, we have made it clear that any patent
  2960. must be licensed for everyone's free use or not licensed
  2961. at all.
  2962.  
  2963.   The precise terms and conditions for copying,
  2964. distribution and modification follow.
  2965.  
  2966.                 GNU GENERAL PUBLIC LICENSE
  2967.             TERMS AND CONDITIONS FOR COPYING,
  2968.               DISTRIBUTION AND MODIFICATION
  2969.  
  2970.   0. This License applies to any program or other work
  2971. which contains a notice placed by the copyright holder
  2972. saying it may be distributed under the terms of this
  2973. General Public License.  The "Program", below, refers to
  2974. any such program or work, and a "work based on the
  2975. Program" means either the Program or any derivative work
  2976. under copyright law: that is to say, a work containing the
  2977. Program or a portion of it, either verbatim or with
  2978. modifications and/or translated into another language.
  2979. (Hereinafter, translation is included without limitation
  2980. in the term "modification".)  Each licensee is addressed
  2981. as "you".
  2982.  
  2983. Activities other than copying, distribution and
  2984. modification are not covered by this License; they are
  2985. outside its scope.  The act of running the Program is not
  2986. restricted, and the output from the Program is covered
  2987. only if its contents constitute a work based on the
  2988. Program (independent of having been made by running the
  2989. Program).  Whether that is true depends on what the
  2990. Program does.
  2991.  
  2992.   1. You may copy and distribute verbatim copies of the
  2993. Program's source code as you receive it, in any medium,
  2994. provided that you conspicuously and appropriately publish
  2995. on each copy an appropriate copyright notice and
  2996. disclaimer of warranty; keep intact all the notices that
  2997. refer to this License and to the absence of any warranty;
  2998. and give any other recipients of the Program a copy of
  2999. this License along with the Program.
  3000.  
  3001. You may charge a fee for the physical act of transferring
  3002. a copy, and you may at your option offer warranty
  3003. protection in exchange for a fee.
  3004.  
  3005.   2. You may modify your copy or copies of the Program or
  3006. any portion of it, thus forming a work based on the
  3007. Program, and copy and distribute such modifications or
  3008. work under the terms of Section 1 above, provided that you
  3009. also meet all of these conditions:
  3010.  
  3011.     a) You must cause the modified files to carry
  3012. prominent notices stating that you changed the files and
  3013. the date of any change.
  3014.  
  3015.     b) You must cause any work that you distribute or
  3016. publish, that in whole or in part contains or is derived
  3017. from the Program or any part thereof, to be licensed as a
  3018. whole at no charge to all third parties under the terms of
  3019. this License.
  3020.  
  3021.     c) If the modified program normally reads commands
  3022. interactively when run, you must cause it, when started
  3023. running for such interactive use in the most ordinary way,
  3024. to print or display an announcement including an
  3025. appropriate copyright notice and a notice that there is no
  3026. warranty (or else, saying that you provide a warranty) and
  3027. that users may redistribute the program under these
  3028. conditions, and telling the user how to view a copy of
  3029. this License.  (Exception: if the Program itself is
  3030. interactive but does not normally print such an
  3031. announcement, your work based on the Program is not
  3032. required to print an announcement.)
  3033.  
  3034. These requirements apply to the modified work as a whole.
  3035. If identifiable sections of that work are not derived from
  3036. the Program, and can be reasonably considered independent
  3037. and separate works in themselves, then this License, and
  3038. its terms, do not apply to those sections when you
  3039. distribute them as separate works.  But when you
  3040. distribute the same sections as part of a whole which is a
  3041. work based on the Program, the distribution of the whole
  3042. must be on the terms of this License, whose permissions
  3043. for other licensees extend to the entire whole, and thus
  3044. to each and every part regardless of who wrote it.
  3045.  
  3046. Thus, it is not the intent of this section to claim rights
  3047. or contest your rights to work written entirely by you;
  3048. rather, the intent is to exercise the right to control the
  3049. distribution of derivative or collective works based on
  3050. the Program.
  3051.  
  3052. In addition, mere aggregation of another work not based on
  3053. the Program with the Program (or with a work based on the
  3054. Program) on a volume of a storage or distribution medium
  3055. does not bring the other work under the scope of this
  3056. License.
  3057.  
  3058.   3. You may copy and distribute the Program (or a work
  3059. based on it, under Section 2) in object code or executable
  3060. form under the terms of Sections 1 and 2 above provided
  3061. that you also do one of the following:
  3062.  
  3063.     a) Accompany it with the complete corresponding
  3064. machine-readable source code, which must be distributed
  3065. under the terms of Sections 1 and 2 above on a medium
  3066. customarily used for software interchange; or,
  3067.  
  3068.     b) Accompany it with a written offer, valid for at
  3069. least three years, to give any third party, for a charge
  3070. no more than your cost of physically performing source
  3071. distribution, a complete machine-readable copy of the
  3072. corresponding source code, to be distributed under the
  3073. terms of Sections 1 and 2 above on a medium customarily
  3074. used for software interchange; or,
  3075.  
  3076.     c) Accompany it with the information you received as
  3077. to the offer to distribute corresponding source code.
  3078. (This alternative is allowed only for noncommercial
  3079. distribution and only if you received the program in
  3080. object code or executable form with such an offer, in
  3081. accord with Subsection b above.)
  3082.  
  3083. The source code for a work means the preferred form of the
  3084. work for making modifications to it.  For an executable
  3085. work, complete source code means all the source code for
  3086. all modules it contains, plus any associated interface
  3087. definition files, plus the scripts used to control
  3088. compilation and installation of the executable.  However,
  3089. as a special exception, the source code distributed need
  3090. not include anything that is normally distributed (in
  3091. either source or binary form) with the major components
  3092. (compiler, kernel, and so on) of the operating system on
  3093. which the executable runs, unless that component itself
  3094. accompanies the executable.
  3095.  
  3096. If distribution of executable or object code is made by
  3097. offering access to copy from a designated place, then
  3098. offering equivalent access to copy the source code from
  3099. the same place counts as distribution of the source code,
  3100. even though third parties are not compelled to copy the
  3101. source along with the object code.
  3102.  
  3103.   4. You may not copy, modify, sublicense, or distribute
  3104. the Program except as expressly provided under this
  3105. License.  Any attempt otherwise to copy, modify,
  3106. sublicense or distribute the Program is void, and will
  3107. automatically terminate your rights under this License.
  3108. However, parties who have received copies, or rights, from
  3109. you under this License will not have their licenses
  3110. terminated so long as such parties remain in full
  3111. compliance.
  3112.  
  3113.   5. You are not required to accept this License, since
  3114. you have not signed it.  However, nothing else grants you
  3115. permission to modify or distribute the Program or its
  3116. derivative works.  These actions are prohibited by law if
  3117. you do not accept this License.  Therefore, by modifying
  3118. or distributing the Program (or any work based on the
  3119. Program), you indicate your acceptance of this License to
  3120. do so, and all its terms and conditions for copying,
  3121. distributing or modifying the Program or works based on
  3122. it.
  3123.  
  3124.   6. Each time you redistribute the Program (or any work
  3125. based on the Program), the recipient automatically
  3126. receives a license from the original licensor to copy,
  3127. distribute or modify the Program subject to these terms
  3128. and conditions.  You may not impose any further
  3129. restrictions on the recipients' exercise of the rights
  3130. granted herein.  You are not responsible for enforcing
  3131. compliance by third parties to this License.
  3132.  
  3133.   7. If, as a consequence of a court judgment or
  3134. allegation of patent infringement or for any other reason
  3135. (not limited to patent issues), conditions are imposed on
  3136. you (whether by court order, agreement or otherwise) that
  3137. contradict the conditions of this License, they do not
  3138. excuse you from the conditions of this License.  If you
  3139. cannot distribute so as to satisfy simultaneously your
  3140. obligations under this License and any other pertinent
  3141. obligations, then as a consequence you may not distribute
  3142. the Program at all.  For example, if a patent license
  3143. would not permit royalty-free redistribution of the
  3144. Program by all those who receive copies directly or
  3145. indirectly through you, then the only way you could
  3146. satisfy both it and this License would be to refrain
  3147. entirely from distribution of the Program.
  3148.  
  3149. If any portion of this section is held invalid or
  3150. unenforceable under any particular circumstance, the
  3151. balance of the section is intended to apply and the
  3152. section as a whole is intended to apply in other
  3153. circumstances.
  3154.  
  3155. It is not the purpose of this section to induce you to
  3156. infringe any patents or other property right claims or to
  3157. contest validity of any such claims; this section has the
  3158. sole purpose of protecting the integrity of the free
  3159. software distribution system, which is implemented by
  3160. public license practices.  Many people have made generous
  3161. contributions to the wide range of software distributed
  3162. through that system in reliance on consistent application
  3163. of that system; it is up to the author/donor to decide if
  3164. he or she is willing to distribute software through any
  3165. other system and a licensee cannot impose that choice.
  3166.  
  3167. This section is intended to make thoroughly clear what is
  3168. believed to be a consequence of the rest of this License.
  3169.  
  3170.   8. If the distribution and/or use of the Program is
  3171. restricted in certain countries either by patents or by
  3172. copyrighted interfaces, the original copyright holder who
  3173. places the Program under this License may add an explicit
  3174. geographical distribution limitation excluding those
  3175. countries, so that distribution is permitted only in or
  3176. among countries not thus excluded.  In such case, this
  3177. License incorporates the limitation as if written in the
  3178. body of this License.
  3179.  
  3180.   9. The Free Software Foundation may publish revised
  3181. and/or new versions of the General Public License from
  3182. time to time.  Such new versions will be similar in spirit
  3183. to the present version, but may differ in detail to
  3184. address new problems or concerns.
  3185.  
  3186. Each version is given a distinguishing version number.  If
  3187. the Program specifies a version number of this License
  3188. which applies to it and "any later version", you have the
  3189. option of following the terms and conditions either of
  3190. that version or of any later version published by the Free
  3191. Software Foundation.  If the Program does not specify a
  3192. version number of this License, you may choose any version
  3193. ever published by the Free Software Foundation.
  3194.  
  3195.   10. If you wish to incorporate parts of the Program into
  3196. other free programs whose distribution conditions are
  3197. different, write to the author to ask for permission.  For
  3198. software which is copyrighted by the Free Software
  3199. Foundation, write to the Free Software Foundation; we
  3200. sometimes make exceptions for this.  Our decision will be
  3201. guided by the two goals of preserving the free status of
  3202. all derivatives of our free software and of promoting the
  3203. sharing and reuse of software generally.
  3204.  
  3205. [Warranty]
  3206.                        NO WARRANTY
  3207.  
  3208.   11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE,
  3209. THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT
  3210. PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED
  3211. IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
  3212. PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND,
  3213. EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED
  3214. TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  3215. FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS TO THE
  3216. QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.
  3217. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
  3218. ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  3219.  
  3220.   12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR
  3221. AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY
  3222. OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM
  3223. AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
  3224. INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
  3225. CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY
  3226. TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
  3227. DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED
  3228. BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO
  3229. OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR
  3230. OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
  3231. DAMAGES.
  3232.  
  3233.                END OF TERMS AND CONDITIONS
  3234.  
  3235.       How to Apply These Terms to Your New Programs
  3236.  
  3237.   If you develop a new program, and you want it to be of
  3238. the greatest possible use to the public, the best way to
  3239. achieve this is to make it free software which everyone
  3240. can redistribute and change under these terms.
  3241.  
  3242.   To do so, attach the following notices to the program.
  3243. It is safest to attach them to the start of each source
  3244. file to most effectively convey the exclusion of warranty;
  3245. and each file should have at least the "copyright" line
  3246. and a pointer to where the full notice is found.
  3247.  
  3248. <one line to give the program's name and a brief idea of
  3249. what it does.>
  3250. Copyright (C) <year>  <name of author>
  3251.  
  3252.     This program is free software; you can redistribute it
  3253. and/or modify it under the terms of the GNU General Public
  3254. License as published by the Free Software Foundation;
  3255. either version 2 of the License, or (at your option) any
  3256. later version.
  3257.  
  3258.     This program is distributed in the hope that it will
  3259. be useful, but WITHOUT ANY WARRANTY; without even the
  3260. implied warranty of MERCHANTABILITY or FITNESS FOR A
  3261. PARTICULAR PURPOSE.  See the GNU General Public License
  3262. for more details.
  3263.  
  3264.     You should have received a copy of the GNU General
  3265. Public License along with this program; if not, write to
  3266. the Free Software Foundation, Inc., 51 Franklin Street,
  3267. Fifth Floor, Boston, MA  02110-1301  USA
  3268.  
  3269. Also add information on how to contact you by electronic
  3270. and paper mail.
  3271.  
  3272. If the program is interactive, make it output a short
  3273. notice like this when it starts in an interactive mode:
  3274.  
  3275. Gnomovision version 69, Copyright (C) year name of author
  3276. Gnomovision comes with ABSOLUTELY NO WARRANTY; for details
  3277. type `show w'.  This is free software, and you are welcome
  3278. to redistribute it under certain conditions; type `show c'
  3279. for details.
  3280.  
  3281. The hypothetical commands `show w' and `show c' should
  3282. show the appropriate parts of the General Public License.
  3283. Of course, the commands you use may be called something
  3284. other than `show w' and `show c'; they could even be
  3285. mouse-clicks or menu items--whatever suits your program.
  3286.  
  3287. You should also get your employer (if you work as a
  3288. programmer) or your school, if any, to sign a "copyright
  3289. disclaimer" for the program, if necessary.  Here is a
  3290. sample; alter the names:
  3291.  
  3292.   Yoyodyne, Inc., hereby disclaims all copyright interest
  3293. in the program `Gnomovision' (which makes passes at
  3294. compilers) written by James Hacker.
  3295.  
  3296.   <signature of Ty Coon>, 1 April 1989
  3297.   Ty Coon, President of Vice
  3298.  
  3299. This General Public License does not permit incorporating
  3300. your program into proprietary programs.  If your program
  3301. is a subroutine library, you may consider it more useful
  3302. to permit linking proprietary applications with the
  3303. library.  If this is what you want to do, use the GNU
  3304. Library General Public License instead of this License.
  3305.  
  3306. [QueryBox]
  3307. Query boxes
  3308.  
  3309. In the query dialog box you can use the arrow keys or the
  3310. first letter to select an item or click with the mouse on
  3311. the button.
  3312.  
  3313. [How to use help]
  3314. How to use help
  3315.  
  3316. You can use the cursor keys or mouse to navigate in the
  3317. help viewer.  Press down arrow  to move to the next item or
  3318. scroll down.  Press up arrow  to move to the previous item
  3319. or scroll up.  Press right arrow  to follow the current
  3320. link.  Press left arrow  to go back in the history of nodes
  3321. that you have visited.
  3322.  
  3323. If you terminal doesn't support the cursor keys you can
  3324. use the space bar  to scroll forward and the b  (back) key
  3325. scroll back.  Use the TAB  key to move to the next item and
  3326. press ENTER  to follow the current link.  The l  (last) key
  3327. can be used to go back in the history of nodes you have
  3328. visited.  Press ESC  to exit the help viewer.
  3329.  
  3330. The left mouse button will follow the link or scroll.  The
  3331. right mouse button can be used to go back in the history
  3332. of nodes.
  3333.  
  3334. The full key list of the help viewer:
  3335.  
  3336. General movement keysGeneral Movement Keys are accepted.
  3337.  
  3338. tab            Move to the next item.
  3339. M-tab          Move to the previous item.
  3340. down           Move to the next item or scroll a line down.
  3341. up             Move to the previous item or scroll a line up.
  3342. right , enter   Follow the current link.
  3343. left , l        Go back in the history of visited nodes.
  3344. F1             Show the help for the help viewer.
  3345. n              Go to the next node.
  3346. p              Go to the previous node.
  3347. c              Go to the Contents node.
  3348. F10 , esc       Exit the help viewer.
  3349. 
  3350. Local variables:
  3351. fill-column: 58
  3352. end:
  3353.